Search...
Log inGet started
Airwallex logo
Home
Core API
Payments
Transactional FX
Payouts
Issuing
Back to home
OverviewHow Airwallex Issuing worksSupported regions and currenciesSupported card programs
Use Cases
Transactions
Purchase lifecycleRetrieve card transactionsHandle transaction disputes
Create disputesReceive dispute updates
Dispute statuses
Simulate transactions on issued cardsTransaction failure reasons
Troubleshooting

Receive dispute updates

Learn how to receive updates about your dispute after you've submitted it to Airwallex.

After successfully submitting a dispute, Airwallex will review the validity of the dispute to determine if there are any dispute rights associated with the transaction. A submission may fail if the transaction is determined to have no dispute rights.

If there is a dispute right, Airwallex will accept the dispute and submits it to the card scheme. The status of the dispute transitions from SUBMITTED to IN_PROGRESS and the webhook event issuing.transaction_dispute.accepted is emitted.

For information on other statuses and webhooks, see Dispute statuses.

For errors returned when dispute rights are not available and other errors, see Error codes.

Dispute resolution

A dispute resolution can take up to 100 days from the time Airwallex submits the dispute to the card scheme.

Dispute CategoryTime to resolution
FraudWithin 70 calendar days
AuthorizationWithin 70 calendar days
Processing ErrorWithin 100 calendar days
ConsumerWithin 100 calendar days

The dispute status will be updated from IN_PROGRESS to either WON or LOST depending on the case result.

Learn how to retrieve detailed status changes for a dispute in IN_PROGRESS status.

Retrieve detailed status changes

For disputes in the dispute category Fraud or Authorization, the detailed_status field returns the following:

Field valueDescription
DISPUTE_FILEDThe dispute is submitted to the card scheme.
PRE_ARB_RECEIVEDThe Merchant/Acquirer does not agree with the dispute and has raised a pre-arbitration.
PRE_ARB_DECLINED_BY_ISSUERAirwallex decided to decline the pre-arbitration and continue to dispute.
ARBITRATION_RECEIVEDBoth Airwallex and the Merchant/Acquirer do not align on liability. The Merchant/Acquirer has raised the case to the card scheme for a ruling.
WONCustomer won the dispute.
LOSTCustomer lost the dispute.

For disputes in the dispute category "Processing Error" or "Consumer", the detailed_status field returns the following:

Field valueDescription
DISPUTE_FILEDThe dispute is submitted to the card scheme.
DISPUTE_DECLINEDThe merchant does not agree with the dispute and has declined the dispute.
PRE_ARB_DELIVEREDAirwallex decided to raise a pre-arbitration and continue to dispute.
PRE_ARB_DECLINED_BY_ACQUIRERMerchant/Acquirer decided to decline the pre-arbitration and continue to dispute.
ARB_DELIVEREDBoth Airwallex and the Merchant/Acquirer do not align on liability. Airwallex raises the case to the card scheme for a ruling. There is a high fee associated with this step.
WONCustomer won the dispute.
LOSTCustomer lost the dispute.
On this page
  • Dispute resolution
  • Retrieve detailed status changes