Skip to content

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

Basic authentication

This enpoint requires a basic authentication

Endpoint

POST /api/purchases/<purchase_uid>/credit_by_transfer

Parameters

ParameterDescription
amount_centsamount in cents to credit, cannot be greater than the purchase amount cents

Request example

json
{
    "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.

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