# Card Issuance Process

## Virtual Card

{% stepper %}
{% step %}
**Get the Card BIN**

Call the [**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins) interface to get the relevant configuration of the card BIN;
{% endstep %}

{% step %}
**Create cardholder(option)**

{% hint style="info" %}
if needCardHolder = true for Support Bins interface, need create cardholder, and Support Bins interface response paramter [metadata.cardHolderModel will return the mode B2B or B2C](#user-content-fn-1)[^1].
{% endhint %}

**B2B, B2C This is merely an internally defined code identifier. It has no relation to company or individual.**\
User can use the `metadata.cardHolderModel` parameter in the \[[**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins)] interface to confirm the cardholder creation method (**`B2B`** and **`B2C`** modes) and proceed to \[[**Cardholder-Create-v2**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-create-v2)]. The cardholder approval progress can be obtained through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-holder-event)] or \[[**Cardholder-list**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-list)] interface. When the cardholder is approved, the next step will be taken.
{% endstep %}

{% step %}
**Create card**

Call the \[[**Create Card-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#create-card-v2)] interface to purchase the card and create the card. The cardholder id needs to be included in the interface. You can get the card opening progress through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-operation-transaction-event)] or \[[**Card Operation Transaction-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-operation-transaction-v2)].
{% endstep %}

{% step %}
**Query card information**

you can query the \[[**card info**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info)] interface to get the basic information of the card by card no. Then query the \[[**Card Info For Sensitive**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info-for-sensitive)] interface to get card sensitive info.
{% endstep %}
{% endstepper %}

## Physical Card

{% stepper %}
{% step %}
**Purchase card offline**

The customer contacts the BD to purchase cards offline in bulk and pays the advance payment. The account manager mails the printed cards to the customer (the customer can know the real card number in this step).
{% endstep %}

{% step %}
**Selling cards**

The customer sells cards to your's users.
{% endstep %}

{% step %}
**Get Card BIN**

Call the [**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins) interface to get the relevant configuration of the card BIN;
{% endstep %}

{% step %}
**Create cardholder**

{% hint style="info" %}
if needCardHolder = true  for Support Bins interface, need create cardholder. Support Bins interface response paramter [metadata.cardHolderModel will return the mode B2B or B2C](#user-content-fn-1)[^1]
{% endhint %}

**B2B, B2C This is merely an internally defined code identifier. It has no relation to company or individual.**

User can use the `metadata.cardHolderModel` parameter in the \[[**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins)] interface to confirm the cardholder creation method (**`B2B`** and **`B2C`** modes) and proceed to \[[**Cardholder-Create-v2**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-create-v2)]. The cardholder approval progress can be obtained through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-holder-event)] or \[[**Cardholder-list**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-list)] interface. When the cardholder is approved, the next step will be taken.
{% endstep %}

{% step %}
**Create card (assign card number)**

Call the \[[**Create Card-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#create-card-v2)] interface to purchase the card and create the card. The cardholder id needs to be included in the interface. You can get the card opening progress through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-operation-transaction-event)] or \[[**Card Operation Transaction-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-operation-transaction-v2)].
{% endstep %}

{% step %}
**Receive activation code**

After calling the create card, the card activation code will be pushed through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-3ds-transaction-event)**]**; at the same time, the activation code will also be sent to the cardholder's mailbox (you can confirm with the account manager whether wasabi needs to send an email to the cardholder). You can obtain it through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-3ds-transaction-event)] or \[[**query activation code**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-3ds-transaction)]
{% endstep %}

{% step %}
**Query card information**

You can query the \[[**card info**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info)] interface to get the basic information of the card by card no. (at this time, the card status is not activated, and the card private information cannot be obtained. card number, cvv, expire date). Then query the \[[**Card Info For Sensitive**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info-for-sensitive)] interface to get card sensitive info when active card.
{% endstep %}

{% step %}
**Card activation**

Call the \[[**Activate Card**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#activate-card-physical)] interface to activate the card.
{% endstep %}

{% step %}
**Query card information**

query the \[[**Card Info For Sensitive**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info-for-sensitive)] interface to get card sensitive info when active card.
{% endstep %}
{% endstepper %}

## Share Card

A shared card is a payment card solution where multiple cards share the same wallet funds, supporting unified credit limit management and real-time transaction control. Through centralized risk control and flexible fund allocation, it improves fund utilization efficiency and reduces management costs, making it suitable for teams and businesses. The interface integration is the same as with prepaid cards; the top-up interface is used for credit allocation, with the top-up amount representing the credit limit, and the withdrawal interface is used to reduce the credit limit.

{% stepper %}
{% step %}
**Get the Card BIN**

Call the [**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins)  interface to obtain the card's relevant configuration. The mode is BUDGET\_CARD, which is the shared mode, and PREPAID\_CARD is the precharged mode.
{% endstep %}

{% step %}
**Create cardholder(option)**

{% hint style="info" %}
if needCardHolder = true for Support Bins interface, need create cardholder, and Support Bins interface response paramter [metadata.cardHolderModel will return the mode B2B or B2C](#user-content-fn-1)[^1].
{% endhint %}

**B2B, B2C This is merely an internally defined code identifier. It has no relation to company or individual.**\
User can use the `metadata.cardHolderModel` parameter in the \[[**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins)] interface to confirm the cardholder creation method (**`B2B`** and **`B2C`** modes) and proceed to \[[**Cardholder-Create-v2**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-create-v2)]. The cardholder approval progress can be obtained through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-holder-event)] or \[[**Cardholder-list**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-list)] interface. When the cardholder is approved, the next step will be taken.
{% endstep %}

{% step %}
**Create card**

Use the \[[**Create Card V2**\]](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#create-card-v2) API to purchase and create a card. **This API supports specifying an account ID for payment; if no account ID is specified**, **it will default to using your wallet account**. You can check the card activation progress via \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-holder-event)]  or  \[[**Card Operation Transaction-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-operation-transaction-v2)].
{% endstep %}

{% step %}
**Query card information**

you can query the \[[**card info**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info)] interface to get the basic information of the card by card no. Then query the \[[**Card Info For Sensitive**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info-for-sensitive)] interface to get card sensitive info.
{% endstep %}
{% endstepper %}

## Gift Card

Gift card not return card number, cvv, expire date, only return activateUrl and user can see all card info and transactions in redemptionUrl domain. and not support deposit, withdraw, freeze, unfreeze api.

{% stepper %}
{% step %}
**Get the Card BIN**

Call the [**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins) interface to get the relevant configuration of the card BIN;
{% endstep %}

{% step %}
**Create cardholder(option)**

{% hint style="info" %}
if needCardHolder = true for Support Bins interface, need create cardholder, and Support Bins interface response paramter [metadata.cardHolderModel will return the mode B2B or B2C](#user-content-fn-1)[^1]
{% endhint %}

**B2B, B2C This is merely an internally defined code identifier. It has no relation to company or individual.**

User can use the `metadata.cardHolderModel` parameter in the \[[**Support Bins**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#support-bins)] interface to confirm the cardholder creation method (**`B2B`** and **`B2C`** modes) and proceed to \[[**Cardholder-Create-v2**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-create-v2)]. The cardholder approval progress can be obtained through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-holder-event)] or \[[**Cardholder-list**](https://wsb.gitbook.io/wasabicard-doc/api/card/card-holder#cardholder-list)] interface. When the cardholder is approved, the next step will be taken.
{% endstep %}

{% step %}
**Create card**

Call the  \[[**Create Card-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#create-card-v2)] interface to create the card. The cardholder id needs to be included in the interface. You can get the card opening progress through \[[**webhook**](https://wsb.gitbook.io/wasabicard-doc/api/webhooks#card-operation-transaction-event)] or \[[**Card Operation Transaction-V2**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-operation-transaction-v2)].
{% endstep %}

{% step %}
**Query card information**\
You can query the \[[**card info**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info)] interface to get the basic information of the card by card no. Then query the \[[**Card Info For Sensitive**](https://wsb.gitbook.io/wasabicard-doc/api/card/cards#card-info-for-sensitive)] interface to get card sensitive info (**only return activateUrl parameter**).
{% endstep %}

{% step %}

###

{% endstep %}
{% endstepper %}

[^1]: