Cancel or freeze a card

You can update card details such as card status, transaction limits, allowed currencies, allowed merchant categories, etc., using Update a card API. If all currencies or all merchant categories are allowed for the card, you can leave the relevant fields blank.

With card status, note that Update a card API only supports the following values in the card_status field:

• INACTIVE (see Freeze a card)
• CLOSED (see Cancel a card)
• ACTIVE (if you want to unfreeze a card)

For other card statuses, see Review card status.

Cancel a card

You can permanently cancel a card in your Airwallex account for any reason and at any time, and this will prevent any new transactions from being made on this card. However, any transaction that has yet to be cleared will continue to be processed even if the card is canceled. Note that once your card is cancelled, it cannot be reversed.

To cancel a card, use Update a card API with the card_id and set card_status to CLOSED.

Example request

Shell
1curl --request POST \
2--url 'https://api-demo.airwallex.com/api/v1/issuing/cards/{{card_id}}/update`
3--header 'Authorization: Bearer <your_bearer_token>'
4--data '{ 
5   "card_status": "CLOSED",
6   "nick_name": "Test Card",
7   "primary_contact_details": {
8       "email": "[email protected]",
9       "full_name": "Postman Test",
10       "mobile_number": "123456789"
11   }
12}
13

Example response

JSON
1{
2    "brand": "VISA",
3   "card_id": "fff8ed9b-0920-41a1-870e-d511f58a43f0",
4   "card_number": "************9833",
5   "card_status": "CLOSED",
6   "created_by": "Postman Test",
7   "form_factor": "VIRTUAL",
8   "issue_to": "ORGANISATION",
9   "name_on_card": "Demo Card",
10   "nick_name": "Test Card",
11   "primary_contact_details": {
12       "email": "[email protected]",
13       "full_name": "Postman Test",
14       "mobile_number": "1-23456789"
15   },
16   "request_id": "d1064ae1-8ff0-4f9a-a5be-6d34dea8dc60",
17   "type": "GOOD_FUNDS_CREDIT"
18}

Freeze a card

Freezing your card prevents any further transactions from being made on the card, virtually, physically or on any of your devices (Google / Apple Pay). It is reversible, and you can unfreeze your card anytime.

To freeze a card, use Update a card API with the card_id and set card_status to INACTIVE.

Example request

Shell
1curl --request POST \
2--url 'https://api-demo.airwallex.com/api/v1/issuing/cards/{{card_id}}/update`
3--header 'Authorization: Bearer <your_bearer_token>'
4--data '{ 
5   "card_status": "INACTIVE",
6   "nick_name": "Test Card",
7   "primary_contact_details": {
8       "email": "[email protected]",
9       "full_name": "Postman Test",
10       "mobile_number": "123456789"
11   }
12}'

Example response

JSON
1{
2    "brand": "VISA",
3   "card_id": "fff8ed9b-0920-41a1-870e-d511f58a43f0",
4   "card_number": "************9833",
5   "card_status": "INACTIVE",
6   "created_by": "Postman Test",
7   "form_factor": "VIRTUAL",
8   "issue_to": "ORGANISATION",
9   "name_on_card": "Demo Card",
10   "nick_name": "Test Card",
11   "primary_contact_details": {
12       "email": "[email protected]",
13       "full_name": "Postman Test",
14       "mobile_number": "1-23456789"
15   },
16   "request_id": "d1064ae1-8ff0-4f9a-a5be-6d34dea8dc60",
17   "type": "GOOD_FUNDS_CREDIT"
18}