Search...
APIJSLog inGet started
Airwallex logo
Home
Platform APIs
Connected Accounts
Accounts
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewAPI
SDKs
Demo environment
Webhooks
Listen for webhook events
Event types
Account capabilityAccount statusBillingChargesConnected Account TransfersConversionsDepositsDirect debit payoutsFunds SplitGlobal AccountsIssuing
Linked AccountsOnline paymentsPlatformPSP AgnosticRFITaxTransfers
Payload examples
Code examples
Test webhook event payloadsView webhook eventsRe-trigger webhook events

Issuing

Card Status Webhooks

Web app LabelEvent TypeDescription
Cards -> Card Pendingissuing.card.pendingCard creation is pending and is under review.
Cards -> Card Failedissuing.card.failedThe request to create a card using Create a card failed.
Cards -> Card Activeissuing.card.activeThe card is active and can be used for transactions.
Cards -> Card Inactiveissuing.card.inactiveThe card is successfully frozen and cannot be used for transactions. However, it can be unfrozen and used again.
Cards -> Card Blockedissuing.card.blockedThe card is in a suspended state as Airwallex has blocked the card.
Cards -> Card Lostissuing.card.lostThe card is marked as lost.
Cards -> Card Stolenissuing.card.stolenThe card is reported as stolen.
Cards -> Card Closedissuing.card.closedThe card is cancelled. This is a terminal state.
Cards -> Card Expiredissuing.card.expiredThe card has expired.

For more details on card status transitions and next steps, please refer to the card status descriptions .

Card Delivery Status Webhooks

Web App LabelEvent TypeDescription
Cards -> Card modifiedissuing.card.modifiedPlease refer to the delivery status descriptions and next steps here .

Cardholder Status Webhooks

Web App LabelEvent TypeDescription
Cardholder -> Cardholder Incompleteissuing.cardholder.incompleteCardholder needs to provide additional details and pass the review process.
Cardholder -> Cardholder Pendingissuing.cardholder.pendingCardholder needs to pass the review process before accessing card details.
Cardholder -> Cardholder Readyissuing.cardholder.readyCardholder has passed the review process and is ready to be issued cards.
Cardholder -> Cardholder Disabledissuing.cardholder.disabledCardholder has been disabled.
Cardholder -> Cardholder Deletedissuing.cardholder.deletedCardholder has been deleted from the account.

Reissuance Webhooks

Web app LabelEvent TypeDescription
Cards -> Successful card reissuanceissuing.reissue.succeededSuccessful reissue of an existing card.

Transaction Webhooks

Web app LabelEvent TypeDescription
Cards -> Successful card transactionissuing.transaction.succeededSuccessful transaction on an issued card.
Cards -> Failed card transactionissuing.transaction.failedFailed transaction on an issued card.

Dispute Webhooks

Web app LabelEvent TypeDescription
Cards -> Dispute draft createdissuing.transaction_dispute.createdThe dispute draft is successfully created. It can be submitted to Airwallex once ready.
Cards -> Dispute draft expiredissuing.transaction_dispute.expiredThere is no dispute rights as the validity period is over.
Cards -> Dispute submitted to Airwallexissuing.transaction_dispute.submittedThe dispute is successfully submitted to Airwallex.
Cards -> Dispute rejected by Airwallexissuing.transaction_dispute.rejectedThe dispute is rejected by Airwallex. You may attempt to resubmit based on the feedback provided.
Cards -> Dispute canceledissuing.transaction_dispute.canceledThe dispute is successfully canceled.
Cards -> Dispute submitted to the card schemeissuing.transaction_dispute.acceptedThe dispute is submitted to the card scheme.
Cards -> Dispute wonissuing.transaction_dispute.wonThe dispute is won.
Cards -> Dispute lostissuing.transaction_dispute.lostThe dispute is lost.
Cards -> Dispute update_history object is updatedissuing.transaction_dispute.modifiedThe dispute notes is updated and there may be actions to take.