Card Payouts
Send funds directly to a recipient's card
2 min readUpdated Mar 24, 2026
A card payout (credit push) sends funds to a recipient's card. Common use cases: disbursements, marketplace seller payouts, withdrawal flows.
#How It Works
Submit the recipient's card details, amount, and currency. The response returns immediately with transactionStatus: "PROCESSING". The final result arrives via webhook — do not retry on PROCESSING.
#Payout Lifecycle
| Status | Meaning |
|---|---|
NEW | Accepted by Exirom |
PENDING | Sent to card network |
SUCCEED | Funds credited to recipient's card |
FAILED | Payout rejected — check declineCode |
Settlement typically takes 1–3 business days depending on the card network and issuing bank.
#Webhook Callback
Exirom sends a POST to your callbackUrl with:
| Field | Description |
|---|---|
transactionId | Payout transaction identifier |
transactionStatus | Final status (SUCCEED or FAILED) |
declineCode | Set on failure |
cardMask | Masked recipient card number |
totalAmount | Amount transferred |
createdAt | ISO 8601 timestamp |
#Related
- Card Payout Flow — End-to-end flow diagram
- API Reference: POST /api/v1/payouts/card — Full endpoint spec, parameters, Try It
- API Reference: GET /api/v1/payouts/card/status/{id} — Check payout status
- Transaction Status Guide — All status values
Was this helpful?