Apply For a Physical Card

This is a synchronous interface. 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-physical

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.Fix Value:4
card_bin*	string	Card Bin .Please contact customer manager.
order_count	integer	Order count. Default value: 1
name_on_card_printing_type*	integer	Cardholder Name Printing Method Enums: 1-Cardholder name and business name 2-cardholder name only 3-business name only If it is 3-business name only ,cardholder binding required later. Please refer to Bind Holder.
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_ids	list<long>	Cardholder IDs. Mandatory if name_on_card_printing_type is 1-Cardholder name and business name or 2-cardholder name only . Otherwise optional.
shipping_method*	integer	Shipping method Enums: 2-standard 3-DHL
delivery_address_id*	long	Delivery address ID Refer to Delivery Address

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": 4,
        "order_count":1,
        "holder_ids": [103006],
        "is_share_card": true,
        "card_bin": "658704",
        "name_on_card_printing_type":1,
        "shipping_method":2,
        "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
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,
        "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"
}