Airwallex logo

Manage Cards

Card management APIs allow you to manage your cards and associated transactions.

Card Cancellation

You can cancel a card 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 cancelled.

Sample Request

curl --request POST \
--url 'https://api-demo.airwallex.com/api/v1/issuing/cards/6c2dc266-09ad-4235-b61a-767c7cd6d6ea/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNTI1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
--data '{ \
  "card_status": "CLOSED" \
}'

Card Details Update

Card details such as spending limits, allowed currencies, allowed merchant categories can be updated. If all currencies or all merchant categories are allowed for the card, you can leave the relevant fields blank.

Sample Request

curl --request POST \
--url 'https://api-demo.airwallex.com/api/v1/issuing/cards/6c2dc266-09ad-4235-b61a-767c7cd6d6ea/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNTI1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
--data '{ \
  "authorization_controls": { \
    "allowed_currencies": [ \
      "USD", \
      "AUD" \
    ], \
    "allowed_merchant_categories": [ \
      "7531", \
      "7534" \
    ], \
    "transaction_limits": { \
      "limits": [ \
        { \
          "amount": 1000, \
          "interval": "PER_TRANSACTION" \
        } \
      ] \
    } \
  }, \
  "card_status": "INACTIVE" \
}'

Manage your card via WebApp

manage card