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 API which returns a card_id. You would then use this card_id to get card details API.

Once created, the card (Virtual or Physical) can be added to a Digital Wallet (e.g Google Pay) if in a supported region. See FAQ for more information.

Please note:

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 API request with the relevant Card ID;
To find out the remaining limits for any card under your account, please invoke Get card remaining limits API with the relevant Card ID;
Issued cards are Active and can be used to transact straight away;
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:

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

curl --request POST \
--url 'https://pci-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": { \
    "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" \
    ], \
    "allowed_transaction_count": "SINGLE", \
    "transaction_limits": { \
      "currency": "USD", \
      "limits": [ \
        { \
          "amount": 1000, \
          "interval": "PER_TRANSACTION" \
        } \
      ] \
    } \
  }, \
  "cardholder_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2", \
  "client_data": "20190817_dfelsflkj73494lksdfg9480ww", \
  "created_by": "John Smith", \
  "form_factor": "VIRTUAL", \
  "issue_to": "ORGANISATION", \
  "nick_name": "travelling", \
  "note": "This is my first card.", \
  "primary_contact_details": { \
    "email": "john@example.com", \
    "full_name": "John Smith", \
    "mobile_number": "619922334321" \
  }, \
  "request_id": "7f687fe6-dcf4-4462-92fa-80335301d9d2", \
  "type": "PREPAID" \
}'

Create a Card via WebApp

Select 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

Create Cards

.css-1xcsryl>.e1x8zjqq1{opacity:0;-webkit-transition:opacity 250ms ease-in-out;transition:opacity 250ms ease-in-out;}.css-1xcsryl:hover>.e1x8zjqq1{opacity:1;}Sample Request.css-158icaa{margin-left:4px;}

Create a Card via WebApp

Sample Request