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

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 Refer to CardSchema
card_type*	integer	Card type.Refer to:CardType
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: Use Existing Cardholder Provide a valid holder_id from your registered cardholders Create New Cardholder Complete all cardholder information fields Upload supporting KYC documents Pass compliance verification
contact_id	long	Card Contact Id Refer to Card Contact
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	Refer to ：IdType
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	Refer to: Gender
holder.nationality_code*	string(2)	Nationality code Refer to CountryCode
holder.address.line*	string(12-128)	The first line of the address. Format:CHARSETS_4
holder.address.line2	string(128)	The second line of the address. Format:CHARSETS_4
holder.address.postal_code*	string(4-8)	The address zip code, or postal code
holder.address.city_name*	string(4-80)	The address city Format:CHARSETS_6
holder.address.state*	string(4-48)	The address state Format:CHARSETS_6
holder.address.country_code*	string(2)	Country code.Refer to CountryCode

Request Example

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!

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 status.Refer to: OrderStatus
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

200:OK

{
    "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.

400: invalid-signature