Refund

Returns money to the client for a paid invoice: fully or in parts.

Only an invoice in status success can be refunded, within 6 months after the payment.

For a partial refund, pass amount and currency. Several partial refunds are possible while their sum does not exceed the invoice amount.

Without amount, the full invoice amount is refunded: this works only if there were no refunds yet.

The invoice status stays success. Refunds are listed in refunds of Info.

If state_callback was passed, a notification with the new refund_id is sent.

HTTP	`refund_status`	Meaning	Next step
`200`	`success`	The refund is completed.	—
`200`	`process`	The refund is in progress.	Check `refunds` in Info later. A new refund is possible after this one is completed.
`200`	`error`	The payment system rejected the refund.	See `error_code` and `error_description`.
`400`, `401`, `422`, `500`	—	The request is rejected.	See «Errors» below.

The error is returned in error_description; error_code is returned for 401, 422 and for the 400 errors that have a code below.

HTTP	`error_code`	When	What to do
`400`	`3001`	The invoice or its payment is not found.	Check `id`.
`400`	`3004`	The invoice is not paid.	Check the status with Status.
`400`	`3007`	The previous refund is still in progress.	Repeat the request after it is completed.
`400`	`3008`	More than 6 months have passed since the payment.	The refund is not possible.
`400`	`5001`	The refund amount exceeds the rest of the invoice amount.	Reduce `amount`.
`401`	`9998`	The signature is invalid.	Check the signature: see Overview.
`422`	`9403`	The X-JWS-Signature header is missing.	Pass the signature.
`500`	—	A field is missing or invalid, for example `currency` with `amount`. `error_description` names the field.	Fix the request.

Responses

🟢200OK

application/json

Headers

Bodyapplication/json

Example

{
    "refund_status": "success",
    "refund_id": "019d0653-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
    "refund_created_at": "2026-10-29T17:59:29+05:00"
}

🟠400Bad Request

🟠401Unauthorized

🟠422Unprocessable Entity

🔴500Internal Server Error

Request