Store refunds
Retry the buyer payout for a refund
POST
/refunds/{id}/retry-payoutScope
refunds:writeAuth Bearer keyIdempotentRe-sends or re-queries the payout under the refund's own rail reference. The refund itself is never re-booked and a settled payout is never sent twice.
Path parameters
idstringrequiredHeaders
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Responses
200Refund
json
{
"id": "ref_9d02f8b71ac5",
"object": "refund",
"order_id": "ord_74b1c0e9a2",
"status": "completed",
"kind": "partial",
"currency": "USDC",
"amount": "37.33",
"reason": "Partial return — one of three items",
"payout_status": "succeeded",
"payout_reference": "SFR-9D02F8B71AC5",
"payout_attempts": 2,
"payout_failure_reason": null,
"destination": {
"type": "crypto",
"address": "0x8Ae2C1b7F0d94E31aA5c60b17E9C4d3f0821b7A5",
"network": "BASE"
},
"livemode": true,
"created_at": "2026-08-30T11:22:09.771Z"
}Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X POST "https://business.boundlesspay.com/api/public/v1/refunds/{id}/retry-payout" \
-H "Authorization: Bearer $BOUNDLESS_API_KEY" \
-H "Idempotency-Key: $(uuidgen)"