Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
Get started
QuickstartManage API keys
Webhooks
Listen for webhook events
Event types
Payload examples
AccountBillingChargesConnected Account TransfersConversionsDepositsDirect debit payoutsGlobal AccountsIssuing
Linked AccountsOnline PaymentsPlatformRFI Transfers
Code examples
Test webhook event payloadsView webhook eventsRe-trigger webhook events

Issuing

Listed below are the webhook events relevant for Issuing:

  • issuing.transaction.succeeded
  • issuing.transaction.failed
  • issuing.reissue.succeeded
JSON

Examples of different issuing event data objects are displayed below.

Authorization and clearing

As described in the Purchase lifecycle docs, card transactions may come to you in two phases:

In the first phase, you would receive an issuing.transaction.succeeded authorization event (matching the AUTHORIZATION event type in the Get Transactions API) with the following payload:

JSON

In the second phase, if your transaction authorization succeeded, you would receive an issuing.transaction.succeeded event (matching the CLEARING event type in the Get Transactions API) within 7 days with the following payload. You can match clearing events to their corresponding authorization events using the matched_authorizations field:

JSON
  • If your transaction authorization failed, you would receive an issuing.transaction.failed event with the following payload:
JSON
  • If your transaction authorization was reversed or has not been cleared within 7 days, you would receive an issuing.transaction.succeeded event (matching the REVERSAL event type in the Get Transactions API) with the following payload. The matched_authorizations field indicates the original authorization that was reversed:
JSON

Single-phase transactions

Card transactions may come to you in one single phase and you would only receive one issuing.transaction.succeeded event (matching the CLEARING event type in the Get Transactions API) with the following payload:

JSON

Refunds

In the event of a refund (of a previously cleared transaction), you would receive an issuing.transaction.succeeded event (matching the REFUND event type in the Get Transactions API) with the following payload:

JSON

Reissue of cards

In the event Airwallex renews an issued card you would receive an issuing.reissue.succeeded event with the following payload. The card ID will remain the same while other details such as the expiry date and CVV will be updated.

JSON
On this page
  • Authorization and clearing
  • Single-phase transactions
  • Refunds
  • Reissue of cards