Sign in

v1

latestOpenAPI 3.1.02026-07-2432337285.3 KB
Accounts

Refund Deposit

Create a refund for a deposit. Only deposit movements with operation_type = CREDIT are eligible.

A refund may still fail after being initially marked as SUCCESS; in such cases, you'll receive a callback with status = FAILED.

To simulate a failed refund in the sandbox, create a deposit with amount = 101 (see the Create Deposit endpoint for details).

To refund a Payin, use the Create Refund endpoint from Payins.

post/movements/refund/

Headers

x-company-idinteger

ID of a child company for authentication. If not provided, the parent company will be authenticated.

ID of a child company for authentication. If not provided, the parent company will be authenticated.

Request body

movement_idinteger required

Movement ID to refund

idempotency_keystring

A unique key that ensures a request is processed only once. If the same key is sent with multiple requests, the server returns the original response instead of performing the action again.

descriptionstring

Description for the refund. If supported by the rail, this will be forwarded to the end user. Only alphanumeric characters are allowed.

callback_urlstring

Callback URL to receive the refund updates.

Response

Successful Response

status'success'