Skip to main content
POST
Request a Fiat Refund
Fiat refunds are an opt-in feature that must be enabled for your account by the Ripio team. While it is disabled, every request returns 403 Forbidden with the error code 20056 (FiatRefundNotEnabledException), and refundable is always false on your orders.

Authorizations

Authorization
string
header
required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Path Parameters

customerId
string<uuid>
required

Unique identifier for the customer.

orderId
string<uuid>
required

Unique identifier for the order.

Body

application/json

Body of a fiat refund request. Send fiatAccountId only when refundDestinationRequired is true.

fiatAccountId
string<uuid>

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.

Example:

"3c9f1f0e-6a2d-4a7c-9f1e-2b8d4c5a6e7f"

Response

A refund already exists for this deposit; nothing new was created.

Acknowledgement of a fiat refund request.

refundId
string<uuid>

Unique identifier of the refund.

status
enum<string>

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).

Available options:
PENDING,
PROCESSING,
COMPLETED,
REJECTED,
FAILED,
CANCELLED
depositUuid
string<uuid>

Identifier of the deposit being refunded.