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

Apply Physical Card

User Apply a Physical card

Synchronous interface, 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-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 agency name 2-cardholder name only 3-agency name only If it is 3-agency 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 agency name or 2-cardholder name only .Optional otherwise.
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