List Refundable Crypto Deposits
Returns the customer’s crypto deposits that arrived at one of their off-ramp deposit addresses and matched no order. Crypto twin of GET /customers/{customerId}/refundableDeposits/: the object is a payment with no operation behind it, so it appears on no transaction listing — this is the only place you see it.
By default the list answers what can still be claimed: only the deposits a new refund can be requested for. A deposit whose refund is under way or already completed is not listed; one whose previous request was rejected is, and its latestRefund carries the reason.
With ?includeRequested=true it answers where the customer’s crypto is: the same deposits plus the ones whose refund was already requested and has not landed on-chain yet, each carrying its state in latestRefund. A deposit leaves the list only when its refund reaches COMPLETED. In that wider mode the presence of a deposit no longer means it can be claimed: read latestRefund to tell the two apart (null or REJECTED → a refund can be requested; any other state → one is already under way).
Only deposits whose matching has concluded are listed. A deposit that arrived seconds ago and may still find its order is held back, because refunding it would return crypto an imminent match is about to sell. The refund endpoint deliberately accepts it and answers 409 / 20077, which is the one refusal you can retry later.
Both modes require off-ramp refunds to be enabled for your account. While they are not, the claimable half is left out of both: the endpoint answers 200 with no such deposits rather than offering ones a request would then reject with 403 / 20072. An empty page therefore does not mean the customer has no unmatched deposits. What ?includeRequested=true still returns in that case is any deposit whose refund Ripio support already started on the customer’s behalf.
This endpoint serves API integrations. Deposits made through an off-ramp session always get an order, so a widget-only integration has none of these.
Authorizations
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Path Parameters
Unique identifier for the customer.
Query Parameters
Also list the deposits whose refund was already requested and has not been credited yet. Omit it (the default) to list only the deposits a new refund can be requested for. Any value other than true reads as false.
Maximum number of items to return.
x >= 1Starting point to limit the total items to return (for pagination).
x >= 0Response
Paginated list of the customer's refundable crypto deposits.
Paginated list of a customer's refundable crypto deposits.