Add New Refund Receipt

Production

https://{{subdomain}}.daftra.com/api2

POST

/refund_receipts{format}

Creates a new refund receipt against an existing invoice.

A refund receipt is always issued against a source invoice: set Invoice.subscription_id to that invoice's id (required — an empty/invalid value is rejected). The client, currency and related details are inherited from the source invoice. The request body otherwise has the same shape as Add New Invoice (an Invoice object plus optional InvoiceItem, Payment, etc.); a RefundReceipt object is also accepted in place of Invoice, and the document type is set to refund receipt automatically.

See Add New Invoice for the full reference of the remaining header / item / payment fields.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

The refund receipt was created.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/refund_receipts.json' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Invoice": {
        "subscription_id": 2415,
        "date": "2026-06-25",
        "currency_code": "USD"
    },
    "InvoiceItem": [
        {
            "item": "Consulting service",
            "unit_price": 100,
            "quantity": 1,
            "product_id": 12
        }
    ],
    "Payment": [
        {
            "payment_method": "cash",
            "amount": 100
        }
    ]
}'

Response Example

202 - Example 1

{
    "result": "successful",
    "code": 202,
    "id": 6031,
    "invoice_number": "RR-0001"
}

GET Single Refund Receipt

Edit Refund Receipts