Log inGet started
Airwallex logo
Home
Online Payments
Treasury
Transactional FX
Payouts
Issuing
Scale
Open Banking
Developer Tools
API Reference
Home
Issuing
Overview
Issuing Use Cases
Getting Started
Create CardsManage Cards
Creating CardholdersManage CardholdersView Transactions
Merchant Category Codes

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://pci-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://pci-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": { \
    "active_from": "2018-10-31T00:00:00+0800", \
    "active_to": "2018-10-31T00:00:00+0800", \
    "allowed_currencies": [ \
      "USD", \
      "AUD" \
    ], \
    "allowed_merchant_categories": [ \
      "7531", \
      "7534" \
    ], \
    "transaction_limits": { \
      "currency": "USD", \
      "limits": [ \
        { \
          "amount": 1000, \
          "interval": "PER_TRANSACTION" \
        } \
      ] \
    } \
  }, \
  "card_status": "INACTIVE", \
}'

Manage your card via WebApp

manage card