Create commercial cards

Create consumer cards

Physical and digital cards

Whitelabel card offering

Card statuses

Create cards

A quick introduction to building with Airwallex APIs

Quickstart

Explore our comprehensive reference to integrate with Airwallex API endpoints

API Reference

Learn how to receive push notifications via webhooks

Webhooks

Airwallex’s commercial cards enable you to pay for your business-related expenses. This tutorial guides you through the steps for creating personalized and non-personalized commercial cards. 

Commercial cards can be issued to either [Delegate or Individual type](/issuing__create-cardholders__cardholder-types) cardholders and can be [personalized or non-personalized](/issuing__supported-card-programs#personalized-vs.-non-personalized).

Create a commercial card

Next steps

Airwallex's consumer cards enable you pay out to consumers using the issued cards. Consumer use cases include: influencers, gig- economy workers, general payroll, etc. Airwallex has the licenses and infrastructure to support consumer card use cases across a number of jurisdictions worldwide.

Depending on your business requirements, you may also be required to integrate with Airwallex’s [Banking as a Service](/banking-as-a-service__overview) offering and onboard your customers as an [Individual](/banking-as-a-service__kyc-and-onboarding__native-api__individual-kyc-requirements) (not a Business) to access consumer cards.

This tutorial guides you through the steps for creating personalized consumer cards.


Consumer cards can only be issued to [Individual type](/issuing__create-cardholders__cardholder-types) cardholders and as [personalized cards](/issuing__supported-card-programs#personalized-vs.-non-personalized).

Create a consumer card

The information on this page is relevant only for API version `2024-03-31` and later. For older API versions, see [Physical and digital cards] (/issuing__create-a-card-(older-api-versions)__create-individual-cards-(older-api-versions)__physical-and-digital-cards-(older-api-versions)).

Learn how to create physical personalized cards and add personalized cards (physical/virtual) to a digital wallet. 


Physical cards

Digital cards

With Airwallex Issuing, you have the option to customize any of our products to match your company brand and offerings. Depending on the specific product(s) to be whitelabeled, the level of effort required varies. Nevertheless, our capabilities enable you to offer a product that aligns with your brand identity while Airwallex manages operations behind the scenes.

To assess your eligibility and to get started with any of our whitelabel solutions including access to comprehensive documentation, reach out to your Airwallex Account Manager.

Whitelabel virtual cards

Whitelabel physical cards

Whitelabel digital cards

Whitelabel 3DS

Whitelabel issuing notifications

This page describes the status transitions for cards.

<table>
  <thead>
    <tr>
      <th width="20%">Status</th>
      <th width="40%">Description</th>
      <th width="40%">Next steps</th>
 </tr>
  </thead>
  <tbody>
      <tr>
        <td><code>PENDING</code></td>
      <td>The request to create the card has been received and is under review. </td>
        <td>For individual cards, the cardholder status must be <code>READY</code> for the card request to proceed. If you do not wish to proceed with the card request, you can cancel (<code>CLOSED</code>) the card using <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards__id__update/post">Update a card</a> endpoint.</td>
    </tr>
        <tr>
        <td><code>ACTIVE</code></td>
      <td>The request to create the card was successful and the card is ready to use. </td>
          <td>You can choose to cancel (<code>CLOSED</code>) or freeze (<code>INACTIVE</code>) the card using <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards__id__update/post">Update a card</a> endpoint.</td>
    </tr>
     <tr>
        <td><code>INACTIVE</code></td>
      <td>The request to freeze the card has been successful. </td>
       <td>You can choose to cancel (<code>CLOSED</code>) or activate (<code>ACTIVE</code>) the card again using <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards__id__update/post">Update a card</a> endpoint.</td>
    </tr>
       <tr>
        <td><code>BLOCKED</code></td>
      <td>The card was blocked by Airwallex due to suspicious activity. </td>
         <td>Contact Airwallex to re-activate (<code>ACTIVE</code>) or cancel (<code>CLOSED</code>) the card.</td>
    </tr>
       <tr>
        <td><code>LOST</code></td>
      <td>The card has been reported as lost to Airwallex.  </td>
         <td>Contact Airwallex  or use <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards__id__update/post">Update a card</a> endpoint to cancel (<code>CLOSED</code>) the card.</td>
    </tr>
     <tr>
        <td><code>STOLEN</code></td>
      <td>You've reported a stolen card to Airwallex.</td>
         <td>Contact Airwallex  or use <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards__id__update/post">Update a card</a> endpoint to cancel (<code>CLOSED</code>) the card.</td>
    </tr>
       <tr>
        <td><code>CLOSED</code></td>
      <td>You've cancelled a pending, active, or inactive card using <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards__id__update/post">Update a card</a> endpoint or Airwallex has canceled a lost, stolen, or blocked card.</td>
         <td>No action needed.</td>
    </tr>
   <tr>
        <td><code>FAILED</code></td>
      <td>The request to create a card using <a href="/docs/api#/Issuing/Cards/_api_v1_issuing_cards_create/post">Create a card</a> failed.</td>
         <td>Fix any errors and re-submit the request.</td>
    </tr>
     <tr>
        <td><code>EXPIRED</code></td>
      <td>This status is unused because Airwallex handles the card expiration process by automatically renewing the card for an additional 3 years.  The primary account number (PAN) remains the same, the expiry date and CVV will be updated. The associated `card_id` remains unchanged throughout the renewal process.</td>
         <td>N/A</td>
    </tr>
     </tbody>
</table> 

The information within this section is relevant only for API version `2024-03-31` and later. For older API versions, see [Create a card](/issuing__create-a-card-(older-api-versions)).

The Issuing Cards API provides the flexibility for creating cards tailored to fit your use case. After determining your issuing solution (see [Choose your issuing solution](/issuing__choose-your-issuing-solution)), you can start building your integration for your business requirements. 


All Airwallex cards require an associated cardholder(s). See [Create cardholders](/issuing__create-cardholders). 

- Familiarize yourself with the Airwallex [card offering](/issuing__supported-card-programs). 
- Contact your Airwallex Account Manager to enable Cards, Issuing APIs, and other required configuration for your Airwallex account (see [Integration checklist](/issuing__integration-checklist#test-in-the-demo-environment)).
- [Obtain your access token](/api#/Authentication/API_Access/_api_v1_authentication_login/post) by authenticating to Airwallex using your unique Client ID and API key. You will need the access token to make API calls.
- Make sure you have sufficient funds in your Airwallex Wallet for future card spend. For more information, see [Fund your issuing balance](/issuing__fund-your-issuing-balance). 
- Ensure your onboarding obligations have been met and your account is active.
- (Optional) Set up [webhooks](/developer-tools__listen-for-webhook-events) to receive notifications on [issuing events](/developer-tools__listen-for-webhook-events__event-types__issuing). 


Before you begin

- [Create commercial cards](/issuing__create-cards__create-commercial-cards)
- [Create consumer cards](/issuing__create-cards__create-consumer-cards)
- [Physical and digital cards](/issuing__create-cards__physical-and-digital-cards)
- [Whitelabel cards](/issuing__create-cards__whitelabel-card-offering)


Build your card integration

docsLogo

Install the Airwallex Google Pay Payments App

Getting Started

Install Airwallex Card Payments app

Install Airwallex Online Payments App

Install Airwallex Klarna Payments App

Install Airwallex Afterpay Payments App

Install the Airwallex Apple Pay Payments App

Shopline

Supported currencies

 Micro-deposit verification

Transfer webhooks (older versions)

Desktop/Mobile Website Browser - Afterpay / Clearpay

Afterpay / Clearpay

Pakistan

Bangladesh

Indonesia

Market & infrastructure coverage

Settlement report

Transaction & fee types

Payment activity export

Payments rounding logic

Reporting

Enable Native Credit/Debit Cards

Hungary

Zambia

Wallis and Futuna

Virgin Islands (British)

Viet Nam

Vanuatu

Uzbekistan

Uruguay

United States

United Kingdom

United Arab Emirates

Ukraine

Uganda

Turkey

Tunisia

Togo

Timor-Leste

Thailand

Tanzania, United Republic of

Tajikistan

Taiwan (China)

Switzerland

Sweden

Sri Lanka

Spain

South Africa

Slovenia

Slovakia

Singapore

Seychelles

Serbia

Senegal

Saudi Arabia

San Marino

Saint Pierre and Miquelon

Saint Martin (French part)

Saint Lucia

Saint Barthélemy

Rwanda

Romania

Réunion

Republic of the Congo

Qatar

Puerto Rico

Portugal

Poland

Philippines

Peru

Paraguay

Panama

Palestine, State of

Oman

Norway

Nigeria

Niger

New Zealand

New Caledonia

Netherlands

Nepal

Namibia

Morocco

Montenegro

Albania

Algeria

Andorra

Angola

Anguilla

Antigua and Barbuda

Argentina

Armenia

Aruba

Australia

Austria

Azerbaijan

Bahrain

Belgium

Belize

Benin

Bolivia

Bosnia and Herzegovina

Botswana

Brazil

Bulgaria

Burkina Faso

Cambodia

Cameroon

Canada

Canary Islands

Central African Republic

Chad

Chile

China

Colombia

Costa Rica

Côte d'Ivoire

Croatia

Curaçao

Cyprus

Czech Republic

Denmark

Dominican Republic

Dominica

Ecuador

Egypt

El Salvador

Equatorial Guinea

Estonia

Faroe Islands

Fiji

Finland

France

French Guiana

French Polynesia

French Southern Territories

Gabon

Gambia

Georgia

Germany

Gibraltar

Greece

Greenland

Grenada

Guatemala

Guernsey

Guinea-Bissau

Guyana

Honduras

Hong Kong SAR

Iceland

India

Ireland

Isle of Man

Israel

Italy

Jamaica

Japan

Jersey

Jordan

Kazakhstan

Payout network

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;}Before you begin.css-158icaa{margin-left:4px;}

Build your card integration

Before you begin