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 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
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",
    "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 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

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