Skip to main content
POST
Refund a Deposit

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.

depositUuid
string<uuid>
required

Unique identifier for the deposit.

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.