Bag DocsAPI ReferenceRefunds
List Refunds
Retrieve all refunds for your merchant account.
List Refunds
GET /api/refundsReturns up to 50 refunds for the authenticated merchant, sorted by most recent first.
Authentication
Requires API key or Supabase session auth.
Query parameters
| Parameter | Type | Description |
|---|---|---|
mode | string | Filter by mode: live or test. Defaults to live. |
Response
{
"status": "success",
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"transactionId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"merchantWalletAddress": "0xYourWallet",
"customerWalletAddress": "0xCustomerWallet",
"amount": 29.99,
"token": "USDC",
"network": "base",
"mode": "live",
"txHash": "0xabc123...",
"reason": "Customer requested refund",
"status": "completed",
"createdAt": "2026-03-01T12:00:00.000Z"
}
]
}