Card Refunds
Reverse a card payment and return funds to the cardholder
2 min readUpdated Aug 3, 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 refundId and transactionStatus: "PROCESSING". The final status arrives via webhook.
#Webhook Callback
| Field | Description |
|---|---|
refundId | Unique refund transaction identifier |
transactionId | Original card-payment transaction ID, not the refund ID |
requestId | Merchant correlation ID that distinguishes refunds of the same payment |
transactionStatus | SUCCEED or FAILED |
declineCode | Set on failure |
totalAmount | Amount refunded |
createdAt | ISO 8601 timestamp |
Refund checksum identity
Verify
X-Checksum using transactionId|requestId|transactionStatus. For refunds, transactionId is the original card-payment ID; do not substitute refundId. The payload's refundId is not signed. Process idempotently using the three signed values so multiple refunds of one payment cannot be conflated.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/info/{id} — Check refund status and retrieve full details
- Transaction Status Guide — All status values
Was this helpful?