Retrieve card transactions
You can retrieve transactions processed against a specific card or all cards associated with your Airwallex account. You can also retrieve a specific transaction by ID.
Retrieve all card transactions
Use Get transactions API to retrieve all card transactions associated with your account, for a specific card or all cards. You can refine the list using the following query parameters:
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: Funds reserved on the card in response to an authorization requestCLEARING: Funds equivalent to the authorized amount deducted from account balanceREFUND: Funds equivalent to the purchase amount refunded back to account balanceREVERSAL: The requested authorization has been reversed.ORIGINAL_CREDIT: Merchant-initiated credit transactions
Example request
Shell1curl --request GET \2--url 'https://api-demo.airwallex.com/api/v1/issuing/transactions'3--header 'Authorization: Bearer <your_bearer_token>'
Example response
JSON1{2 "has_more": false,3 "items": [4 {5 "auth_code": "248723",6 "billing_amount": -1,7 "billing_currency": "USD",8 "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",9 "card_nickname": "Postman Test Card",10 "masked_card_number": "************3725",11 "merchant": {12 "category_code": "7531",13 "city": "MELB TEST1",14 "country": "AUS",15 "name": "CARD_TX_GENERATOR"16 },17 "network_transaction_id": "6821237754268198",18 "posted_date": "2021-12-10T11:09:05.523+0000",19 "retrieval_ref": "115277031202",20 "status": "PENDING",21 "transaction_amount": -1,22 "transaction_currency": "USD",23 "transaction_date": "2021-12-10T11:09:05.523+0000",24 "transaction_id": "ca7cdecc-6fca-4a99-b593-471824211471",25 "transaction_type": "AUTHORIZATION"26 },27 {28 "auth_code": "278941",29 "billing_amount": -2,30 "billing_currency": "USD",31 "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",32 "card_nickname": "Postman Test Card",33 "masked_card_number": "************3725",34 "merchant": {35 "category_code": "7531",36 "city": "MELB TEST1",37 "country": "AUS",38 "name": "CARD_TX_GENERATOR"39 },40 "network_transaction_id": "2612193580965623",41 "posted_date": "2021-12-10T11:09:23.073+0000",42 "retrieval_ref": "414555052604",43 "status": "PENDING",44 "transaction_amount": -2,45 "transaction_currency": "USD",46 "transaction_date": "2021-12-10T11:09:23.073+0000",47 "transaction_id": "6f84b971-892a-41fc-b5e2-22e5599628b7",48 "transaction_type": "AUTHORIZATION"49 },50 {51 "auth_code": "716232",52 "billing_amount": -3,53 "billing_currency": "USD",54 "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",55 "card_nickname": "Postman Test Card",56 "masked_card_number": "************3725",57 "merchant": {58 "category_code": "7531",59 "city": "MELB TEST1",60 "country": "AUS",61 "name": "CARD_TX_GENERATOR"62 },63 "network_transaction_id": "8466488605137767",64 "posted_date": "2021-12-10T11:09:33.651+0000",65 "retrieval_ref": "890962172971",66 "status": "APPROVED",67 "transaction_amount": -3,68 "transaction_currency": "USD",69 "transaction_date": "2021-12-10T11:09:33.651+0000",70 "transaction_id": "e374475c-e6ef-4e63-89e6-757fe5e05f9f",71 "transaction_type": "CLEARING"72 }73 ]74}
Retrieve a card transaction
If you want to retrieve details of a specific transaction on the card, call Get single transaction API by specifying the unique identifier of the transaction in the endpoint URL. You can retrieve the transaction_id from Get transactions API.
Example request
Shell1curl --request GET \2--url 'https://api-demo.airwallex.com/api/v1/issuing/transactions/<issuing_transaction_id>'3--header 'Authorization: Bearer <your_bearer_token>'
Example response
JSON1{2 "has_more": false,3 "items": [4 {5 "auth_code": "248723",6 "billing_amount": -1,7 "billing_currency": "USD",8 "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",9 "card_nickname": "Postman Test Card",10 "masked_card_number": "************3725",11 "merchant": {12 "category_code": "7531",13 "city": "MELB TEST1",14 "country": "AUS",15 "name": "CARD_TX_GENERATOR"16 },17 "network_transaction_id": "6821237754268198",18 "posted_date": "2021-12-10T11:09:05.523+0000",19 "retrieval_ref": "115277031202",20 "status": "PENDING",21 "transaction_amount": -1,22 "transaction_currency": "USD",23 "transaction_date": "2021-12-10T11:09:05.523+0000",24 "transaction_id": "ca7cdecc-6fca-4a99-b593-471824211471",25 "transaction_type": "AUTHORIZATION"26 },27 {28 "auth_code": "278941",29 "billing_amount": -2,30 "billing_currency": "USD",31 "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",32 "card_nickname": "Postman Test Card",33 "masked_card_number": "************3725",34 "merchant": {35 "category_code": "7531",36 "city": "MELB TEST1",37 "country": "AUS",38 "name": "CARD_TX_GENERATOR"39 },40 "network_transaction_id": "2612193580965623",41 "posted_date": "2021-12-10T11:09:23.073+0000",42 "retrieval_ref": "414555052604",43 "status": "PENDING",44 "transaction_amount": -2,45 "transaction_currency": "USD",46 "transaction_date": "2021-12-10T11:09:23.073+0000",47 "transaction_id": "6f84b971-892a-41fc-b5e2-22e5599628b7",48 "transaction_type": "AUTHORIZATION"49 },50 {51 "auth_code": "716232",52 "billing_amount": -3,53 "billing_currency": "USD",54 "card_id": "841e1115-b092-49ac-8186-d2e00196bf22",55 "card_nickname": "Postman Test Card",56 "masked_card_number": "************3725",57 "merchant": {58 "category_code": "7531",59 "city": "MELB TEST1",60 "country": "AUS",61 "name": "CARD_TX_GENERATOR"62 },63 "network_transaction_id": "8466488605137767",64 "posted_date": "2021-12-10T11:09:33.651+0000",65 "retrieval_ref": "890962172971",66 "status": "APPROVED",67 "transaction_amount": -3,68 "transaction_currency": "USD",69 "transaction_date": "2021-12-10T11:09:33.651+0000",70 "transaction_id": "e374475c-e6ef-4e63-89e6-757fe5e05f9f",71 "transaction_type": "CLEARING"72 }73 ]74}
Was this page helpful?