Card Refunds
Reverse a card payment and return funds to the cardholder
1 min readUpdated Mar 24, 2026
A refund reverses a previously successful card payment. Both full and partial refunds are supported. You need the transactionId from a SUCCEED transaction.
#Full vs Partial Refund
| Type | How |
|---|---|
| Full | Omit the amount field — entire transaction amount is refunded |
| Partial | Include amount less than the original — multiple partial refunds can be issued against the same transaction up to the original amount |
The response returns immediately with a refundTransactionId and transactionStatus: "PROCESSING". The final status arrives via webhook.
#Webhook Callback
| Field | Description |
|---|---|
refundId | Unique refund transaction identifier |
transactionId | Original payment transaction ID |
transactionStatus | SUCCEED or FAILED |
declineCode | Set on failure |
totalAmount | Amount refunded |
createdAt | ISO 8601 timestamp |
Cardholders typically see the credit within 3–10 business days.
#Related
- Refund Flow — End-to-end flow diagram
- API Reference: POST /api/v1/refunds/card — Full endpoint spec, parameters, Try It
- API Reference: GET /api/v1/refunds/card/status/{id} — Check refund status
- Transaction Status Guide — All status values
Was this helpful?