> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/issuing-card-api/business/card/apply-for-a-card.md).

# Apply For a Card

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

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

`POST` `/issuing/card/apply`

### **Request Body**

**Refer to :** [**common**](/reference/issuing-card-api/common.md)

**Biz\_data**

<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="/pages/IUBAVFEJ6eG4BaecRqPS">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="/pages/mWxtcxL92MtLeF8JcrbO">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="/pages/28s2q7TLynYgzTZSNmWJ">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="/pages/208TZIoFAPdTB3JUN96T">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="/pages/d6NXotmcBrZalN5bZUZg">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="/pages/DAV89NXw6qWwTFdZgbtU">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="/pages/w7pZUOuFKrMPYqBRi0OG">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="/pages/w7pZUOuFKrMPYqBRi0OG">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="/pages/w7pZUOuFKrMPYqBRi0OG">CHARSETS_</a><a href="/pages/w7pZUOuFKrMPYqBRi0OG">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="/pages/w7pZUOuFKrMPYqBRi0OG">CHARSETS_</a><a href="/pages/w7pZUOuFKrMPYqBRi0OG">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="/pages/DAV89NXw6qWwTFdZgbtU">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="/pages/MmF50weZUWhJvCttY7XH">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 %}