Refunds
Refund a payment
Refund a collected direct receive Payment to the verified payer.
POST
Refund exactly one amount, as a decimal
amount or an amountAtomic (never both), with a reasonCode (customer_request or operational) and a reason. Stableyard derives the destination from independently verified payer evidence; you cannot choose or override it.
Only direct crypto receive Payments can be refunded here. For on-ramp-funded or multi-payer Payments, or a failed payout, contact Stableyard. Idempotency-Key is required; reuse it only with the identical refund request. The refund is returned with 202 Accepted.
See Reconciliation for telling a refund from a recovery.Authorizations
Headers
Path Parameters
Body
application/json
- Create refund request
- Create refund request
Refund exactly one decimal or atomic amount from a supported accepted direct receive Payment. Stableyard derives the payer destination from verified receipt evidence. Failed external payouts are returned by Stableyard and cannot be requested through this body.