Store refunds
List refunds
GET
/refundsScope
refunds:readAuth Bearer keyQuery parameters
order_idstringoptionalcursorstringoptionallimitintegeroptionalResponses
200Refund list
json
{
"object": "list",
"data": [
{
"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"
},
{
"id": "ref_5c81a0d4f236",
"object": "refund",
"order_id": "ord_74b1c0e9a2",
"status": "completed",
"kind": "full",
"currency": "NGN",
"amount": "48500.00",
"reason": "Item out of stock",
"payout_status": "succeeded",
"payout_reference": "SFR-5C81A0D4F236",
"payout_attempts": 1,
"payout_failure_reason": null,
"destination": {
"type": "bank",
"bank_name": "Kuda",
"account_number": "••••4417",
"account_name": "Ada Nwosu"
},
"livemode": true,
"created_at": "2026-08-30T11:04:55.318Z"
},
{
"id": "ref_2f77bc90ae13",
"object": "refund",
"order_id": "ord_74b1c0e9a2",
"status": "completed",
"kind": "partial",
"currency": "GHS",
"amount": "120.05",
"reason": "Goodwill adjustment",
"payout_status": "manual",
"payout_reference": null,
"payout_attempts": 0,
"payout_failure_reason": null,
"destination": {
"type": "manual"
},
"livemode": true,
"created_at": "2026-08-30T11:31:40.006Z"
}
],
"next_cursor": null,
"has_more": false
}Errors
Errors use RFC 9457 problem details. Branch on code, and log request_id.
400Bad request401Unauthenticated403Forbidden409Idempotency conflict422Validation error429Rate limitedcURL
curl -X GET "https://business.boundlesspay.com/api/public/v1/refunds" \ -H "Authorization: Bearer $BOUNDLESS_API_KEY"
