Refunds

Back mode

No API needed, refund operations have to be initiated in the PSP back office of the merchant. Refund the virtual card used for the payment, and it will be propagated to the initial buyer.

Transfer mode

For the payment by transfer, the merchant can issue a refund by using this endpoint, with the desired amount_cents in the body.

Authentication

Authentication

For security reasons, an access token is mandatory to use this endpoint (Authentication).

⚠️ Using basic authentication is deprecated.

Endpoint

POST /api/purchases/<purchase_uid>/credit_by_transfer

Parameters

Parameter	Description
amount_cents	amount in cents to credit, cannot be greater than the purchase amount cents

Request example

{
    "amount_cents": 200
}

Response

The endpoint will return a 200 http status code in case of success. You will receive a 4xx http status code along with a raw text explanation in case of error.

Code	Description
200	The request was processed successfully.
400	Invalid amount_cents — The amount is too high.
400	No transfer order item (payment to the merchant) was created before the refund request.
401	Invalid credentials — Incorrect login or password.
403	Unauthorized — The user is not allowed to manage the refund for this purchase.
404	Invalid purchase ID — The specified purchase does not exist.
409	Refund request attempted on a payment made with a virtual card (not allowed).
425	Multiple identical refund requests sent within the same minute.