Apply For a Card

This is a synchronous interface. Card production typically completes within 10 seconds. If the returned order status is not 'completed', you can either:

  • 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

POST /issuing/card/apply

Request Body

Refer to : common

Biz_data

Name
Type
Description

order_no*

string

Order number. Globally unique.

card_scheme*

integer

Card Schema.Fix Value:3

card_type*

integer

card_bin

string

Card Bin .Optional value: 658704、 658705 .Default value: 658704

is_share_card

Boolean

Is Shard Card.Default value: false

shared_account_num

string

Shared Account Num

pay_account_num

string

Pay Account Number

initial_balance

string

Initial Balance

Default:USD

card_remark

string

Card Remark

card_limit.daily_transactions*

integer

Daily Transactions

If card_limit is not null,it is required

Tip: card_limit can be null

card_limit.single_amount*

string

Single Amount

If card_limit is not null ,it is required

Tip: card_limit can be null

card_limit.daily_amount*

string

Daily Amount

If card_limit is not null, it is required

Tip: card_limit can be null

card_limit.monthly_amount*

string

Monthly Amount

If card_limit is not null, it is required

Tip: card_limit can be null

card_limit.total_amount

string

Total Limit .Designed for share card

holder_id

long

Cardholder ID.

Options:

  1. Use Existing Cardholder

  • Provide a valid holder_id from your registered cardholders

  1. Create New Cardholder

  • Complete all cardholder information fields

  • Upload supporting KYC documents

  • Pass compliance verification

holder.mobile*

string(16)

Mobile.Needs to add an international area code

holder.first_name*

string(50)

First name

holder.last_name*

string(50)

Last name

holder.id_no*

string(6-20)

ID number

holder.id_type*

integer

holder.issuance_date

string

Format:yyyy-MM-dd

holder.expires_on

string

Format:yyyy-MM-dd

holder.email*

string(80)

Email

holder.birthday*

string

Date of Birth.Format: yyyy-MM-dd

holder.gender

integer

holder.nationality_code*

string(2)

Nationality code

holder.address.line*

string(12-128)

The first line of the address.

holder.address.line2

string(128)

The second line of the address.

holder.address.postal_code*

string(4-8)

The address zip code, or postal code

holder.address.city_name*

string(4-80)

The address city

holder.address.state*

string(4-48)

The address state

holder.address.country_code*

string(2)

Request Example

{
    "app_id": "00000000000000000",
    "partner_id": "00000000000000000",
    "sub_partner_id": "",
    "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!

Response

Name
Type
Description

card_id

long

Card ID

holder_id

long

Cardholder ID

holder_name

string

Cardholder name

order_no

string

Order number

order_status

integer

order_count

integer

Order count

card_token

string

Card token

card_pan

string

Card pan

card_scheme

integer

Card scheme

card_type

integer

Card type

is_share_card

boolean

Is share card

card_bin

string

Card Bin

{
    "code": "10000",
    "msg": "Success",
    "total": 1,
    "random_key": "<random key used for decryption>",
    "sign_type": "RSA",
    "app_id": "00000000000000000",
    "data": {
        "card_id": 103077,
        "holder_id": 103006,
        "order_no": "E1d6c70E-FcFB-8dFf-",
        "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.

Last updated

Was this helpful?