Retrieve card transactions

Retrieve transaction details for specific cards or all cards associated with your Airwallex account.

You can retrieve transactions processed against issued cards in your Airwallex account. This helps you track spending, reconcile transactions, and analyze card usage patterns.

Before you begin

Obtain your API credentials from the Airwallex web app.
Have at least one active card in your account with transaction history.

Retrieve all transactions

To retrieve all card transactions or filter transactions by specific criteria, complete these steps:

Call the Get transactions API endpoint.
Add query parameters to refine your results:
- card_id: Returns transactions specific to this card.
- from_created_date, to_created_date: Returns transactions between the specified time period, inclusive of start and end dates. If you do not specify either of the fields, defaults to a 30-day period.
- page_num, page_size: Breaks down the transaction list as per the specified pagination parameters.
- billing_currency: The 3-letter ISO-4217 currency code in which the transaction was billed.
- retrieval_ref: A unique identifier for the transaction assigned by the acquirer.
- transaction_type: Filters the transaction list based on the specified transaction type. Possible values:
  - AUTHORIZATION: An authorization request is sent to the issuer to determine the validity of the card for making a payment. This request can either be approved or declined.
  - CLEARING: A clearing request is sent to the issuer to complete the settlement of a previously approved authorization request.
  - REFUND: A refund request is sent to the issuer to refund a previously cleared transaction. This can either be a merchant refund or a dispute refund.
  - REVERSAL: A reversal request is sent to the issuer to reverse a previously approved authorization request.
  - ORIGINAL_CREDIT: A credit request is sent to the issuer to facilitate money movement from the merchant to the cardholder.
Send the request:
Shell
```
1curl --request GET \
2  --url 'https://api-demo.airwallex.com/api/v1/issuing/transactions?card_id=<card_id>&transaction_type=CLEARING' \
3  --header 'Authorization: Bearer <your_bearer_token>'
```

The response returns a list of transactions matching your filters:

JSON

1{
2  "has_more": false,
3  "items": [
4    {
5      "acquiring_institution_identifier": "123456",
6      "auth_code": "000001",
7      "billing_amount": 100,
8      "billing_currency": "USD",
9      "card_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2",
10      "card_nickname": "Airwallex Test Card",
11      "client_data": "Client data",
12      "digital_wallet_token_id": "2af871b8-466e-465e-a8de-eeaac9f82392",
13      "failure_reason": "INSUFFICIENT_FUNDS",
14      "fee_details": [
15        {
16          "amount": 10,
17          "currency": "USD",
18          "type": "ATM_ACCESS_FEE"
19        }
20      ],
21      "lifecycle_id": "95ede192-3a86-461e-96d9-f51b55aae79e",
22      "masked_card_number": "************4242",
23      "matched_authorizations": [
24        "6c2dc266-09ad-4235-b61a-767c7cd6d6ea"
25      ],
26      "merchant": {
27        "additional_merchant_info": {
28          "merchant_category": "Professional Services",
29          "merchant_full_name": "Meta",
30          "merchant_logo_url": "https://example.com/merchant-logo.png",
31          "merchant_sub_category": "Advertising and Marketing"
32        },
33        "category_code": "4829",
34        "city": "San Francisco",
35        "country": "USA",
36        "identifier": "012345678910123",
37        "name": "Merchant A",
38        "postcode": "94111",
39        "state": "CA"
40      },
41      "network_transaction_id": "3951729271768745",
42      "posted_date": "2025-03-22T16:08:02+00:00",
43      "retrieval_ref": "909916088001",
44      "risk_details": {
45        "risk_actions_performed": [
46          "TRANSACTION_BLOCKED"
47        ],
48        "risk_factors": [
49          "Suspicious transaction velocity"
50        ],
51        "three_dsecure_outcome": "AUTHENTICATED"
52      },
53      "status": "APPROVED",
54      "transaction_amount": 100,
55      "transaction_currency": "USD",
56      "transaction_date": "2025-03-21T16:08:02+00:00",
57      "transaction_id": "6c2dc266-09ad-4235-b61a-767c7cd6d6ea",
58      "transaction_type": "CLEARING"
59    }
60  ]
61}

Retrieve a specific transaction

To retrieve details of a specific transaction, complete these steps:

Obtain the transaction_id from the Get transactions API endpoint response or from a webhook event.

Call the Get single transaction API endpoint with the transaction ID:

Shell

1curl --request GET \
2  --url 'https://api-demo.airwallex.com/api/v1/issuing/transactions/<transaction_id>' \
3  --header 'Authorization: Bearer <your_bearer_token>'

The response returns the complete transaction details:

JSON

1{
2  "has_more": false,
3  "items": [
4    {
5      "acquiring_institution_identifier": "123456",
6      "auth_code": "000001",
7      "billing_amount": 100,
8      "billing_currency": "USD",
9      "card_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2",
10      "card_nickname": "Airwallex Test Card",
11      "client_data": "Client data",
12      "digital_wallet_token_id": "2af871b8-466e-465e-a8de-eeaac9f82392",
13      "failure_reason": "INSUFFICIENT_FUNDS",
14      "fee_details": [
15        {
16          "amount": 10,
17          "currency": "USD",
18          "type": "ATM_ACCESS_FEE"
19        }
20      ],
21      "lifecycle_id": "95ede192-3a86-461e-96d9-f51b55aae79e",
22      "masked_card_number": "************4242",
23      "matched_authorizations": [
24        "6c2dc266-09ad-4235-b61a-767c7cd6d6ea"
25      ],
26      "merchant": {
27        "additional_merchant_info": {
28          "merchant_category": "Professional Services",
29          "merchant_full_name": "Meta",
30          "merchant_logo_url": "https://example.com/merchant-logo.png",
31          "merchant_sub_category": "Advertising and Marketing"
32        },
33        "category_code": "4829",
34        "city": "San Francisco",
35        "country": "USA",
36        "identifier": "012345678910123",
37        "name": "Merchant A",
38        "postcode": "94111",
39        "state": "CA"
40      },
41      "network_transaction_id": "3951729271768745",
42      "posted_date": "2025-03-22T16:08:02+00:00",
43      "retrieval_ref": "909916088001",
44      "risk_details": {
45        "risk_actions_performed": [
46          "TRANSACTION_BLOCKED"
47        ],
48        "risk_factors": [
49          "Suspicious transaction velocity"
50        ],
51        "three_dsecure_outcome": "AUTHENTICATED"
52      },
53      "status": "APPROVED",
54      "transaction_amount": 100,
55      "transaction_currency": "USD",
56      "transaction_date": "2025-03-21T16:08:02+00:00",
57      "transaction_id": "6c2dc266-09ad-4235-b61a-767c7cd6d6ea",
58      "transaction_type": "CLEARING"
59    }
60  ]
61}

Next steps

Now that you've retrieved card transactions, you can:

Was this page helpful?