Store refunds
Refund a store order
POST
/refundsScope
refunds:writeAuth Bearer keyIdempotentBooks a full or partial refund against a paid order: your balance is debited once and the buyer payout runs on the collecting rail. Retrying with the same Idempotency-Key returns the original refund instead of debiting again.
Headers
Idempotency-KeystringrequiredRetrying with the same key and payload replays the original response.
Request body
json
{
"order_id": "ord_74b1c0e9a2",
"amount": "37.33",
"reason": "Partial return — one of three items",
"destination": {
"type": "crypto",
"address": "0x8Ae2C1b7F0d94E31aA5c60b17E9C4d3f0821b7A5",
"network": "BASE"
}
}Responses
201Refund
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": "processing",
"payout_reference": "SFR-9D02F8B71AC5",
"payout_attempts": 1,
"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" \
-H "Authorization: Bearer $BOUNDLESS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{ "order_id": "ord_74b1c0e9a2", "amount": "37.33", "reason": "Partial return — one of three items", "destination": { "type": "crypto", "address": "0x8Ae2C1b7F0d94E31aA5c60b17E9C4d3f0821b7A5", "network": "BASE" } }'