Skip to main content


This method allows businesses to refund the full or partial amount paid for an order. Full refunds are possible for payments made through card, Apple Pay, Google Pay, or BOG authorization, while partial refunds are applicable only for a card, Apple Pay and Google Pay. It is not possible to cancel a refunding process once it has been initiated. Additionally, partial refunding can only be called until the full amount is refunded.

Header parameters


AuthorizationrequiredBasic <base64>

Bearer <jwt_token>, where jwt_token is the token returned in the access_token parameter of the authentication method response.

Idempotency-KeyoptionalUUID v4

The Idempotency-Key parameter should be unique for each new API request. Subsequent requests to the same API endpoint with the same Idempotency-Key header will result in the server returning the same status code and response body as the initial request. This functionality is particularly useful to ensure consistent outcome in scenarios where network issues or retries may lead to duplicate requests.

Path parameters


The order identifier is returned in response to the order request.

Body parameters


The amount to be refunded. This parameter is necessary if a partial refund is being made (in the case of payment by a card, Apple Pay or Google Pay). If the parameter is not included, the entire amount will be refunded. The value of this parameter cannot exceed the processed amount (transfer_amount).
curl -X POST '' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/json' \
--data-raw '{
"amount": "10.5"



The key or identifier for the status of the API request.


The human-readable message associated with the API request.


The unique identifier for the action associated with the API request.
"key": "request_received",
"message": "Refund request received",
"action_id": "5b666901-eb05-4f83-abeb-8311e175f337"