# Apply For a Card

* Check the status using the *Query Apply Result* API
* Wait for our asynchronous callback notification

### Apply Card

User  Apply a card

Synchronous interface, the card production is likely to succeed in 10 seconds. If the order status returned by the interface is not completed, you can query it through the Query Apply Result interface or wait for our callback.

### **Request** URI <a href="#payin-by-creditcard" id="payin-by-creditcard"></a>

`POST` `/issuing/card/apply`

### **Request Body**

&#x20;**Refer to :** [**common**](https://docs.pagsmile.com/issuing-card-api/common)

&#x20;**Biz\_data**&#x20;

<table><thead><tr><th width="239.546875">Name</th><th width="166.7109375">Type</th><th width="295.52734375">Description</th></tr></thead><tbody><tr><td>order_no<mark style="color:red;">*</mark></td><td>string</td><td>Order number. Globally unique.</td></tr><tr><td>card_scheme<mark style="color:red;">*</mark></td><td>integer</td><td><p>Card Schema.Fix Value:3</p><p>Refer to <a href="../../data/dictionary-item/cardschema">CardSchema</a></p></td></tr><tr><td>card_type<mark style="color:red;">*</mark></td><td>integer</td><td>Card type.Refer to:<a href="../../data/dictionary-item/cardtype">CardType</a></td></tr><tr><td>card_bin</td><td>string</td><td>Card Bin .Optional value: 658704、 658705 .Default value: 658704</td></tr><tr><td>is_share_card</td><td>Boolean</td><td>Is Shard Card.Default value: false</td></tr><tr><td>shared_account_num</td><td>string</td><td>Shared Account Num</td></tr><tr><td>pay_account_num</td><td>string</td><td>Pay Account Number</td></tr><tr><td>initial_balance</td><td>string</td><td><p>Initial Balance </p><p>Default:USD</p></td></tr><tr><td>card_remark</td><td>string</td><td>Card Remark</td></tr><tr><td>card_limit.daily_transactions<mark style="color:red;">*</mark></td><td>integer</td><td><p>Daily Transactions</p><p>If card_limit is not null,it is required </p><p>Tip: card_limit can be null</p></td></tr><tr><td>card_limit.single_amount<mark style="color:red;">*</mark></td><td>string</td><td><p>Single Amount</p><p>If card_limit is not null ,it is required</p><p>Tip: card_limit can be null</p></td></tr><tr><td>card_limit.daily_amount<mark style="color:red;">*</mark></td><td>string</td><td><p>Daily Amount</p><p>If card_limit is not null, it is required</p><p>Tip: card_limit can be null</p></td></tr><tr><td>card_limit.monthly_amount<mark style="color:red;">*</mark></td><td>string</td><td><p>Monthly Amount</p><p>If card_limit is not null, it is required</p><p>Tip: card_limit can be null</p></td></tr><tr><td>card_limit.total_amount</td><td>string</td><td>Total Limit .Designed for share card</td></tr><tr><td></td><td></td><td></td></tr><tr><td>holder_id</td><td>long</td><td><p>Cardholder ID.</p><p><strong>Options:</strong></p><ol start="1"><li><strong>Use Existing Cardholder</strong></li></ol><ul><li>Provide a valid holder_id from your registered cardholders</li></ul><ol start="2"><li><strong>Create New Cardholder</strong></li></ol><ul><li>Complete all cardholder information fields</li><li>Upload supporting KYC documents</li><li>Pass compliance verification</li></ul></td></tr><tr><td>contact_id</td><td>long</td><td><p>Card Contact Id </p><p>Refer to <a href="card-contact">Card Contact</a></p></td></tr><tr><td>holder.mobile<mark style="color:red;">*</mark></td><td>string(16)</td><td>Mobile.Needs to add an international area code</td></tr><tr><td>holder.first_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>First name</td></tr><tr><td>holder.last_name<mark style="color:red;">*</mark></td><td>string(50)</td><td>Last name</td></tr><tr><td>holder.id_no<mark style="color:red;">*</mark></td><td>string(6-20)</td><td>ID number</td></tr><tr><td>holder.id_type<mark style="color:red;">*</mark></td><td>integer</td><td>Refer to ：<a href="../../data/dictionary-item/idtype">IdType</a></td></tr><tr><td>holder.issuance_date</td><td>string</td><td>Format:yyyy-MM-dd</td></tr><tr><td>holder.expires_on</td><td>string</td><td>Format:yyyy-MM-dd</td></tr><tr><td>holder.email<mark style="color:red;">*</mark></td><td>string(80)</td><td>Email</td></tr><tr><td>holder.birthday<mark style="color:red;">*</mark></td><td>string</td><td>Date of Birth.Format: yyyy-MM-dd</td></tr><tr><td>holder.gender</td><td>integer</td><td>Refer to: <a href="../../data/dictionary-item/gender">Gender</a></td></tr><tr><td>holder.nationality_code<mark style="color:red;">*</mark></td><td>string(2)</td><td><p>Nationality code</p><p>Refer  to <a href="../../data/dictionary-item/countrycode">CountryCode</a></p></td></tr><tr><td>holder.address.line<mark style="color:red;">*</mark></td><td>string(12-128)</td><td><p>The first line of the address. </p><p>Format:<a href="../../data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>holder.address.line2</td><td>string(128)</td><td><p>The second line of the address.</p><p>Format:<a href="../../data/dictionary-item/charsets">CHARSETS_4</a></p></td></tr><tr><td>holder.address.postal_code<mark style="color:red;">*</mark></td><td>string(4-8)</td><td>The address zip code, or postal code</td></tr><tr><td>holder.address.city_name<mark style="color:red;">*</mark></td><td>string(4-80)</td><td><p>The address city</p><p>Format:<a href="../../data/dictionary-item/charsets">CHARSETS_</a><a href="../../data/dictionary-item/charsets">6</a></p></td></tr><tr><td>holder.address.state<mark style="color:red;">*</mark></td><td>string(4-48)</td><td><p>The address state</p><p>Format:<a href="../../data/dictionary-item/charsets">CHARSETS_</a><a href="../../data/dictionary-item/charsets">6</a></p></td></tr><tr><td>holder.address.country_code<mark style="color:red;">*</mark></td><td>string(2)</td><td>Country code.Refer  to <a href="../../data/dictionary-item/countrycode">CountryCode</a></td></tr></tbody></table>

### **Request** Example <a href="#example" id="example"></a>

{% tabs %}
{% tab title="Apply for Existing Holder" %}

```
{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "request_id": "19Fc3ddf-2350-4035-d5D3-cdB58a18",
    "timestamp": "2025-04-07 13:52:25",
    "format": "JSON",
    "version": "2.0",
    "sign_type": "RSA",
    "biz_data": {
        "order_no": "E1d6c70E-FcFB-8dFf-",
        "card_scheme": 3,
        "card_type": 3,
        "holder_id": "103006",
        "is_share_card": true,
        "card_bin": "658704",
        "card_limit": {
            "daily_transactions": 10,
            "single_amount": 100,
            "daily_amount": 1000,
            "monthly_amount": 10000,
            "total_amount": 100000
        }
    },
    "random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
```

{% endtab %}
{% endtabs %}

### Response <a href="#example" id="example"></a>

<table><thead><tr><th width="227.03125">Name</th><th width="174.890625">Type</th><th>Description</th></tr></thead><tbody><tr><td>card_id</td><td>long</td><td>Card ID</td></tr><tr><td>holder_id</td><td>long</td><td>Cardholder ID</td></tr><tr><td>holder_name</td><td>string</td><td>Cardholder name</td></tr><tr><td>order_no</td><td>string</td><td>Order number</td></tr><tr><td>order_status</td><td>integer</td><td>Order status.Refer to: <a href="../../data/dictionary-item/cardorderstatus">OrderStatus</a></td></tr><tr><td>order_count</td><td>integer</td><td>Order count</td></tr><tr><td>card_token</td><td>string</td><td>Card token</td></tr><tr><td>card_pan</td><td>string</td><td>Card pan</td></tr><tr><td>card_scheme</td><td>integer</td><td>Card scheme</td></tr><tr><td>card_type</td><td>integer</td><td>Card type</td></tr><tr><td>is_share_card</td><td>boolean</td><td>Is share card</td></tr><tr><td>card_bin</td><td>string</td><td>Card Bin</td></tr></tbody></table>

{% tabs %}
{% tab title="200:OK" %}

<pre><code>{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "&#x3C;random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "card_id": 103077,
        "holder_id": 103006,
<strong>        "order_no": "E1d6c70E-FcFB-8dFf-",
</strong>        "order_status": 2,
        "holder_name": "Test User",
        "card_token": null,
        "card_pan": null,
        "card_bin": "658704",
        "card_scheme": 3,
        "card_type": 3,
        "is_share_card": true,
        "order_count": 1
    }
}
// The data in this example has already been decrypted.
</code></pre>

{% endtab %}

{% tab title="400: invalid-signature" %}

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```

{% endtab %}
{% endtabs %}