Transactions

You can view transactions processed against individual cards or for all cards created within your organisation.

Endpoints

GET /api/v1/issuing/transactions
GET /api/v1/issuing/transactions/{id}

Get transactions

GET /api/v1/issuing/transactions

Copy for LLMView as Markdown

Retrieve all transactions associated with an account or for a specific card. Will default to a 30 day period unless both to and from created_at request fields are populated.

Parameters

billing_currencystring

Currency in which transaction was billed. (3-letter ISO-4217 code)

card_idstring

Unique Identifier for card

digital_wallet_token_idstring

Unique Identifier for digital token

from_created_atstring

start of Transaction Date in ISO8601 format (inclusive)

lifecycle_idstring

Unique Identifier for lifecycle

page_numinteger

Page number, starts from 0.

page_sizeinteger

Number of results per page

retrieval_refstring

Retrieval reference number

to_created_atstring

end of Transaction Date in ISO8601 format (inclusive)

transaction_typestring

Transaction Type - one of AUTHORIZATION, CLEARING, REFUND, REVERSAL, ORIGINAL_CREDIT. See Issuing Purchase Lifecycle for transaction type definitions.

AUTHORIZATION - Funds reserved due to card usage
CLEARING - Deducting purchase amount from account balance
REFUND - Refunding the purchase amount back to account balance
REVERSAL - Reversing an authorization
ORIGINAL_CREDIT - Merchant initiated credit transactions

Response body - 200 OK

has_moreboolean

itemsarray

items.acquiring_institution_identifierstring

Unique Identifier for acquiring institution

items.auth_codestring

Authorization Code

items.billing_amountnumber

Billing amount

items.billing_currencystring

Billing Currency

items.card_idstring

Unique Identifier for card

items.card_nicknamestring

The nickname of the card used

items.card_transaction_dataobject

Card transaction identifiers associated with this transaction. Omitted for transactions created before January 2025.

items.card_transaction_data.card_transaction_event_idstring

Identifier of the individual card transaction event within the lifecycle. The closest equivalent of the transaction_id field.

items.card_transaction_data.card_transaction_idstring

Identifier of the card transaction. Retrieve its details via GET /api/v1/issuing/card_transactions/{id}.

items.card_transaction_data.card_transaction_lifecycle_idstring

Identifier that links related transactions belonging to the same card payment — such as authorizations, reversals, captures, and refunds — under a single lifecycle.

items.client_datastring

Client data stored against the card record

items.digital_wallet_token_idstring

Unique Identifier for digital token

items.failure_reasonstring

The reason why this transaction failed (if status is FAILED). Can be one of: ACCOUNT_INVALID, CARD_CLOSED, CARD_INACTIVE, CARD_INVALID, CARD_LOST_STOLEN, CARD_NOT_ACTIVATED, CARDHOLDER_VERIFICATION_FAILED, CURRENCY_NOT_ALLOWED, CVV_INVALID, EXPIRY_MISSING, INSUFFICIENT_FUNDS, INTERNAL_ERROR, INVALID_EXPIRY_DATE, LIMIT_EXCEEDED, MERCHANT_CATEGORY_NOT_ALLOWED, NOT_SUPPORTED, PIN_INVALID, PIN_RETRIES_EXCEEDED, REMOTE_AUTH_DECLINED, RESTRICTED_COUNTRY, SUSPECTED_FRAUD, TRANSACTION_BLOCKED, TRANSACTION_BLOCKED_AT_TERMINAL, CARD_REISSUED_TO_NEW_NUMBER, TRANSACTION_USAGE_DISABLED, MERCHANT_COUNTRY_NOT_ALLOWED, MERCHANT_BRAND_NOT_ALLOWED, MERCHANT_BRAND_CATEGORY_NOT_ALLOWED, MERCHANT_BRAND_SUBCATEGORY_NOT_ALLOWED. Learn more about transaction failure reasons .

items.fee_detailsarray

List of fee details associated with the transaction

items.fee_details.amountnumber

Fee amount.

items.fee_details.currencystring

Currency in which the fee is charged (3-letter ISO-4217 code).

items.fee_details.typestring

Fee type. One of: ATM_ACCESS_FEE.

items.lifecycle_idstring

A identifier that links multiple related transactions belonging to the same card payment—such as authorizations, reversals, captures, and refunds—under a single transaction lifecycle. Note: this field will be null for transactions created before January 2025

items.masked_card_numberstring

Masked card number

items.matched_authorizationsarray

List of authorization ids for matching captures and reversals to their corresponding authorization. This is only available for authorizations made after 1st May 2022.

items.merchantobject

merchant of the card transaction

items.merchant.additional_merchant_infoobject

Merchant additional info

items.merchant.additional_merchant_info.merchant_categorystring

Merchant category

items.merchant.additional_merchant_info.merchant_full_namestring

Merchant full name

items.merchant.additional_merchant_info.merchant_logo_urlstring

Merchant logo url

items.merchant.additional_merchant_info.merchant_sub_categorystring

Merchant sub category

items.merchant.category_codestring

Merchant category code

items.merchant.citystring

Merchant city

items.merchant.countrystring

Merchant country. Note: this field might prefixed with state name for some countries, e.g. TXUSA, you should parse the last 3 characters for country code.

items.merchant.identifierstring

Unique identifier for merchant

items.merchant.namestring

Merchant name

items.merchant.postcodestring

Merchant postcode (only for merchants within the US, Canada or Brazil)

items.merchant.statestring

Merchant state (only for merchants within the US, Canada or Brazil)

items.network_transaction_idstring

The transaction unique identifier from VISA network

items.posted_datestring

Date transaction posted

items.retrieval_refstring

Transaction retrieval reference number. Data element 37 of an financial transaction message (https://en.wikipedia.org/wiki/ISO_8583)

items.risk_detailsobject

Risk details provides a comprehensive overview of the risk evaluation for a card transaction, including identified risk factors, actions taken by the risk engine, and the outcome of the 3D Secure authentication process. It encapsulates key elements that assess the potential threat level, safeguard the transaction, and ensure the cardholder’s identity is verified. N.b. this information will only be available for transactions on or after 1st Sept 2024.

items.risk_details.risk_actions_performedarray

Risk actions performed for a card transaction, triggered by rules in our risk engine

items.risk_details.risk_factorsarray

Risk factors are conditions or variables that increase the likelihood of fraud or financial irregularities, assessed by our risk management system to determine the threat level of a transaction

items.risk_details.three_dsecure_outcomestring

The outcome of a 3D Secure authentication process, which verifies the identity of a cardholder during an online purchase. Can be one of: ATTEMPTED, AUTHENTICATED, FAILED, NOT_APPLICABLE, NOT_REQUESTED. Learn more about 3D Secure

items.statusstring

The status of this transaction. Can be one of: APPROVED, CLEARED, EXPIRED, FAILED, PENDING, REVERSED

items.transaction_amountnumber

Transaction amount

items.transaction_currencystring

Transaction currency

items.transaction_datestring

Transaction date

items.transaction_idstring

An unique id for this authorization, a uuid

items.transaction_typestring

Transaction type - one of AUTHORIZATION, CLEARING, REFUND, REVERSAL, ORIGINAL_CREDIT

Errors

Error status	Description
400	Possible errors: `field_required`, `bad_request`, `invalid_argument`
401	Possible errors: `credentials_invalid`, `credentials_expired`
429	Too many requests
500	Service unavailable

GET /api/v1/issuing/transactions

$curl --request GET \
>  --url 'https://api-demo.airwallex.com/api/v1/issuing/transactions' \
>  --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
>  --header 'Content-Type: application/json'

Response (200 OK)

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      "client_data": "Some client data",
11      "digital_wallet_token_id": "2af871b8-466e-465e-a8de-eeaac9f82392",
12      "failure_reason": "INSUFFICIENT_FUNDS",
13      "fee_details": [
14        {
15          "amount": 500,
16          "currency": "USD",
17          "type": "ATM_ACCESS_FEE"
18        }
19      ],
20      "lifecycle_id": "95ede192-3a86-461e-96d9-f51b55aae79e",
21      "masked_card_number": "************4242",
22      "matched_authorizations": [
23        "6c2dc266-09ad-4235-b61a-767c7cd6d6ea"
24      ],
25      "merchant": {
26        "additional_merchant_info": {
27          "merchant_category": "Professional Services",
28          "merchant_full_name": "Meta",
29          "merchant_logo_url": "https://example.com/merchant-logo.png",
30          "merchant_sub_category": "Advertising and Marketing"
31        },
32        "category_code": "4829",
33        "city": "San Francisco",
34        "country": "USA",
35        "identifier": "012345678910123",
36        "name": "Merchant A",
37        "postcode": "94111",
38        "state": "CA"
39      },
40      "network_transaction_id": "3951729271768745",
41      "posted_date": "2018-03-22T16:08:02+00:00",
42      "retrieval_ref": "909916088001",
43      "risk_details": {
44        "risk_actions_performed": [
45          "TRANSACTION_BLOCKED"
46        ],
47        "risk_factors": [
48          "Suspicious transaction velocity"
49        ],
50        "three_dsecure_outcome": "AUTHENTICATED"
51      },
52      "status": "APPROVED",
53      "transaction_amount": 100,
54      "transaction_currency": "USD",
55      "transaction_date": "2018-03-21T16:08:02+00:00",
56      "transaction_id": "6c2dc266-09ad-4235-b61a-767c7cd6d6ea",
57      "transaction_type": "REFUND"
58    }
59  ]
60}

Was this section helpful?

Get single transaction

GET /api/v1/issuing/transactions/{id}

Copy for LLMView as Markdown

Retrieve single transaction

Parameters

idrequiredstring

Unique Identifier for transaction

Response body - 200 OK

acquiring_institution_identifierstring

Unique Identifier for acquiring institution

auth_codestring

Authorization Code

billing_amountnumber

Billing amount

billing_currencystring

Billing Currency

card_idstring

Unique Identifier for card

card_nicknamestring

The nickname of the card used

card_transaction_dataobject

Card transaction identifiers associated with this transaction. Omitted for transactions created before January 2025.

card_transaction_data.card_transaction_event_idstring

Identifier of the individual card transaction event within the lifecycle. The closest equivalent of the transaction_id field.

card_transaction_data.card_transaction_idstring

Identifier of the card transaction. Retrieve its details via GET /api/v1/issuing/card_transactions/{id}.

card_transaction_data.card_transaction_lifecycle_idstring

Identifier that links related transactions belonging to the same card payment — such as authorizations, reversals, captures, and refunds — under a single lifecycle.

client_datastring

Client data stored against the card record

digital_wallet_token_idstring

Unique Identifier for digital token

failure_reasonstring

fee_detailsarray

List of fee details associated with the transaction

fee_details.amountnumber

Fee amount.

fee_details.currencystring

Currency in which the fee is charged (3-letter ISO-4217 code).

fee_details.typestring

Fee type. One of: ATM_ACCESS_FEE.

lifecycle_idstring

masked_card_numberstring

Masked card number

matched_authorizationsarray

List of authorization ids for matching captures and reversals to their corresponding authorization. This is only available for authorizations made after 1st May 2022.

merchantobject

merchant of the card transaction

merchant.additional_merchant_infoobject

Merchant additional info

merchant.additional_merchant_info.merchant_categorystring

Merchant category

merchant.additional_merchant_info.merchant_full_namestring

Merchant full name

merchant.additional_merchant_info.merchant_logo_urlstring

Merchant logo url

merchant.additional_merchant_info.merchant_sub_categorystring

Merchant sub category

merchant.category_codestring

Merchant category code

merchant.citystring

Merchant city

merchant.countrystring

Merchant country. Note: this field might prefixed with state name for some countries, e.g. TXUSA, you should parse the last 3 characters for country code.

merchant.identifierstring

Unique identifier for merchant

merchant.namestring

Merchant name

merchant.postcodestring

Merchant postcode (only for merchants within the US, Canada or Brazil)

merchant.statestring

Merchant state (only for merchants within the US, Canada or Brazil)

network_transaction_idstring

The transaction unique identifier from VISA network

posted_datestring

Date transaction posted

retrieval_refstring

Transaction retrieval reference number. Data element 37 of an financial transaction message (https://en.wikipedia.org/wiki/ISO_8583)

risk_detailsobject

risk_details.risk_actions_performedarray

Risk actions performed for a card transaction, triggered by rules in our risk engine

risk_details.risk_factorsarray

Risk factors are conditions or variables that increase the likelihood of fraud or financial irregularities, assessed by our risk management system to determine the threat level of a transaction

risk_details.three_dsecure_outcomestring

statusstring

The status of this transaction. Can be one of: APPROVED, CLEARED, EXPIRED, FAILED, PENDING, REVERSED

transaction_amountnumber

Transaction amount

transaction_currencystring

Transaction currency

transaction_datestring

Transaction date

transaction_idstring

An unique id for this authorization, a uuid

transaction_typestring

Transaction type - one of AUTHORIZATION, CLEARING, REFUND, REVERSAL, ORIGINAL_CREDIT

Errors

Error status	Description
400	Possible errors: `field_required`, `bad_request`, `invalid_argument`
401	Possible errors: `credentials_invalid`, `credentials_expired`
429	Too many requests
500	Service unavailable

GET /api/v1/issuing/transactions/{id}

$curl --request GET \
>  --url 'https://api-demo.airwallex.com/api/v1/issuing/transactions/transaction_id' \
>  --header 'Authorization: Bearer {{ACCESS_TOKEN}}' \
>  --header 'Content-Type: application/json'

Response (200 OK)

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

Was this section helpful?