Request a Fiat Refund
Requests the return of the fiat deposited for an on-ramp order that was cancelled and could not be completed.
Check refundable on the order before calling: it tells you whether a refund can be requested right now. Whether the request must name a destination account is given by refundDestinationRequired — true means fiatAccountId is required (Colombia, where the provider cannot return the money to its origin), false means the money returns to the account the customer paid from and fiatAccountId is rejected.
The request is idempotent: 202 when the refund is registered, 200 when one already exists for the deposit. Once the refund settles you also receive the ON-RAMP.ORDER.REFUNDED webhook event; a rejected request is only visible in the latestRefund block on the order.
See Refunds for the full model.
Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Path Parameters
Unique identifier for the customer.
Unique identifier for the order.
Body
Body of a fiat refund request. Send fiatAccountId only when refundDestinationRequired is true.
Identifier of an ENABLED fiat account of the same customer, where the money is returned. Rejected by providers that refund to the account the customer paid from.
"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f"
Response
A refund already exists for this deposit; nothing new was created.
Acknowledgement of a fiat refund request.
Unique identifier of the refund.
Current state of the refund: PENDING (registered, not yet sent to the provider), PROCESSING (sent, awaiting confirmation), COMPLETED (the money reached its destination), REJECTED (the request was declined — see rejectionReason — and nothing was sent) or FAILED / CANCELLED (the attempt did not go through; contact Ripio support).
PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, CANCELLED Identifier of the deposit being refunded.