Airwallex logo

Create Cards

The card object is the resource associated with the card issued by Airwallex. It holds details such as linked accounts and card based spending restrictions and so on. The card object will also allow the client to specify who the card is for (themselves or other entities), card form (physical or virtual), and the number of uses (single or multiple).

To set up a card, use the Create a card API which returns a card_id. You would then use this card_id to get card details .

Please note:

  1. The Card Object request will not return the full PAN and CVV but will return a Card ID. To get the card details you will need to invoke a Get sensitive card details request with the relevant Card ID;
  2. To find out the remaining limits for any card under your account, please invoke Get card remaining limits with the relevant Card ID;
  3. Issued cards are Active and can be used to transact straight away;
  4. All Airwallex issued cards are linked to the client’s Airwallex account and funded balancers, so unlike a traditional prepaid product you don't have to lock-in funds on the card when requesting it.

Sample Request

To issue a card you will need to provide the following information:

  • type: Specific a card type, prepaid or debit
  • primary_contact_details: Who do we contact if need about the card
  • request_id: A unique ID specific by the client
  • authorization_controls: Spend controls for the card
  • created_by: Legal name of the user requesting the card
  • form_factor: Form of the card - PHYSICAL or VIRTUAL
  • issue_to: Who the card will be issued to
  • name_on_card: Name to be printed on the card
curl --request POST \
--url 'https://api-demo.airwallex.com/api/v1/issuing/cards/create' \
--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" \
    ], \
    "allowed_transaction_count": "SINGLE", \
    "transaction_limits": { \
      "currency": "USD", \
      "limits": [ \
        { \
          "amount": 1000, \
          "interval": "PER_TRANSACTION" \
        } \
      ] \
    } \
  }, \
  "client_data": "20190817_dfelsflkj73494lksdfg9480ww", \
  "created_by": "John Smith", \
  "form_factor": "VIRTUAL", \
  "issue_to": "ORGANISATION", \
  "name_on_card": "John Smith", \
  "nick_name": "travelling", \
  "note": "This is my first card.", \
  "primary_contact_details": { \
    "date_of_birth": "1945-07-12", \
    "full_name": "John Smith", \
    "mobile_number": "619922334321" \
  }, \
  "request_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2", \
  "type": "PREPAID" \
}'

Create a Card via WebApp

First selected the usage category for the card, this can help with budgeting and cost control.

Create new card1

Then give the card a nickname so you can find it easily.

Add nickname 1

Finally set the spend limits for the card and you are all done.

Spend Limits 1