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.

Retrieve disputes

Use Get all transaction disputes API to search for disputes associated with a transaction. You can filter by any of the following parameters:

• transaction_id: The legacy transaction identifier from the legacy transaction APIs.
• card_transaction_id: The card transaction identifier from the transaction lifecycle model.
• card_transaction_event_id: The card transaction event identifier, when the dispute was raised at the event level.

Each dispute object in the response includes card_transaction_event_id, transaction_id (legacy), additional_info, and other dispute details. Use Get a transaction dispute API to retrieve a single dispute by id, including the update_history field.

If Airwallex requests more information during review, update the dispute using Update a transaction dispute API. You can add note, evidence_files, and additional_info fields to provide the requested details.

Example update request

1{
2  "request_id": "afa85f64-5717-4562-b3fc-2c963f66afb4",
3  "additional_info": {
4    "expected_delivery_date": "2026-03-02T00:00:00.000+0000"
5  }
6}

Example request

1GET /api/v1/issuing/transaction_disputes?card_transaction_id=019d90b7-8098-7000-b039-8614b0081cce

Example response

1{
2  "page_before": "YWZ0ZXI9ZHN0X3Nnc3Q2dDVzYmdoN2NmZWowNG8=",
3  "page_after": "YmVmb3JlPWRzdF9zZ3N0aGR4eGdnb2VtcTdmcXln",
4  "items": [
5    {
6      "id": "9cd8dce8-6257-47da-b7ab-a568c81b9e94",
7      "created_at": "2024-04-12T07:48:00+0000",
8      "updated_at": "2024-04-12T07:48:00+0000",
9      "card_transaction_event_id": "ba7c3952-05d7-4ba0-943f-c942496a31e0",
10      "transaction_id": "ca7c3952-05d7-4ba0-943f-c942496a31e0",
11      "amount": 1.00,
12      "currency": "USD",
13      "reason": "SUSPECTED_FRAUD",
14      "status": "DRAFT",
15      "detailed_status": null,
16      "reference": "A@*Ddkss0@_2",
17      "note": "dummy notes 2",
18      "updated_by": "CUSTOMER"
19    }
20  ]
21}

Dispute resolution

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

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

The detailed_status field returned in Get a transaction dispute API can provide detailed information on a dispute in progress, especially about the interactions between Airwallex and the card scheme.

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

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