Refund a Deposit
Requests the return of a fiat deposit that was received but never matched to an on-ramp order — the ones listed by GET /customers/{customerId}/refundableDeposits/.
Whether the request must name a destination account is given by refundDestinationRequired on the listed deposit: true means fiatAccountId is required (Colombia), 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.DEPOSIT.REFUNDED webhook event.
Deposits whose order was cancelled are refunded through the order instead, with POST /customers/{customerId}/transactions/onramp/{orderId}/refund/.
Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Path Parameters
Unique identifier for the customer.
Unique identifier for the deposit.
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.