Airwallex logo

Authorisation Controls

You can specify how and where the cards you issue may be used, these rules are called Authorisation Controls. Authorisation Controls are specified when a new card is requested but can also be updated later on.

Airwallex Issuing offers the following types of Authorisation Controls:

  1. Currency based controls
  2. Merchant based controls
  3. Transaction based controls

Sample Request

You can modify your Authorisation Controls anytime after your card is requested.

  1. allowed_currencies: If it is absent from request payload, then ALL transaction currencies will be allowed.
  2. allowed_merchant_categories: If it is absent from request payload, then ALL merchant categories will be allowed.
  3. allowed_transaction_count: Specifies whether this card is a SINGLE or MULTIPLE use card when your card is created and CANNOT be modified once requested.
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" \
    ], \
}'

Control Management in WebApp

To modify the Authorisation Controls in WebApp, go to click "Edit card" (see Create a Card in WebApp).