Checking Refund Status
Check a card refund's status and retrieve full details — including declineCode on failure
2 min readUpdated Mar 24, 2026
The info endpoint returns a card refund's current status together with full transaction details — declineCode on failure, amounts, original transaction link, timestamps. Use it as a fallback when the webhook was not received, or to retrieve full refund details for reconciliation.
Prefer webhooks
Use this endpoint as a fallback. The webhook callback is the primary signal for refund completion.
Always use /info — not /status
The
/info/{id} endpoint is the only endpoint that returns declineCode. If a refund is FAILED, /info/{id} tells you why; a status-only response does not.#Key Response Fields
| Field | Description |
|---|---|
refundId | Unique refund identifier |
transactionId | Original payment transaction ID |
transactionStatus | Current status (PROCESSING, SUCCEED, FAILED) |
declineCode | Set on failure — numeric decline reason |
totalAmount | Amount refunded |
createdAt | ISO 8601 creation timestamp |
Status lookup vs webhook identity
Use the refund ID for this status lookup. In a refund webhook, however,
transactionId is the original card-payment ID and the checksum is transactionId|requestId|transactionStatus; never substitute refundId when verifying it.#Related
- Refund Flow — End-to-end flow diagram
- FX Refund Flow — Currency conversion on refunds
- API Reference: GET /api/v1/refunds/card/info/{id} — Full endpoint spec, Try It
- Transaction Status Guide — All status values
- Decline Codes Reference — All decline codes and recommended actions
Was this helpful?