Refunds
Process full or partial refunds for completed stablecoin payments. Refunds are sent as on-chain transactions to the customer’s original wallet address.
How It Works
- Identify the payment - Get the
payment_idfrom a completed checkout or subscription payment - Create a refund - Specify the amount (or leave blank for full refund)
- On-chain transfer - The refund is processed as a stablecoin transfer to the customer’s wallet
💸
Refunds are processed on-chain and typically confirm within minutes, depending on network congestion. You’ll receive a webhook when the refund transaction is confirmed.
Refund Statuses
| Status | Description |
|---|---|
pending | Refund transaction is being prepared |
processing | Transaction submitted, awaiting on-chain confirmation |
succeeded | Refund confirmed on-chain |
failed | Refund could not be processed |
Best Practices
- Keep records: Store the refund ID and transaction hash along with your internal order records
- Partial refunds: Use partial refunds for partial returns or adjustments
- Communicate with customers: Notify customers when refunds are processed, including the transaction hash
- Monitor webhook events: Use webhooks to track refund status changes and confirmations
Available Endpoints
- Create Refund - Create a new refund
- Get Refund - Retrieve refund details
- List Refunds - List all refunds
