Physical Card API
Currently, the following card BINs support physical card applications: 414631, 493728.
- The physical card API only supports applying for physical cards using existing virtual cards. To apply for a new physical card, you must first create a virtual card by performing the card issuance operation. Once you have the virtual card's
cardId
, you can then use the physical card API to apply for the physical card.
Fee Inquiry
Use the List all physical card fees API to query the corresponding fees for the card BIN you wish to apply for a physical card. This will include both the card manufacturing fee and the shipping fee.
Submit Mailing Information
When enabling the Bulk ship physical cards API, users must provide a default shipping address in mainland China. If the shipping information provided is a mainland address, the physical card will be sent to this default address, and the customer will need to forward it to the intended recipient. For non-mainland addresses, the bank will arrange for direct delivery.
- Ensure the uploaded
cardId
belongs to a supported physical card BIN (414631, 493728), as using an unsupported BIN will result in a permission error. - The information uploaded is for the recipient and may differ from the cardholder’s details.
- If the country is CN, the default shipping address will be used. If the country is not CN, the phone number's area code will be checked to confirm if it is 86 (mainland China). Mainland phone numbers cannot be used for non-mainland addresses.
Activation Verification
Identity Verification
Before activating the card, the cardholder's identity must be verified. For mainland China users, use the Confirm cardholder identity API to upload photos of the front and back of the ID card. For non-mainland users, use the Generator cardholder identity url API to create a verification link, which will redirect users to a non-mainland identity authentication page.
- The verification link does not have an expiration time, but there is a limit on the number of uses. Each link can be used for authentication up to three times. A maximum of two links can be generated for the same card, providing a total of six authentication attempts. If all attempts fail, customer support will need to be contacted for manual assistance.
Card Activation
- The six-digit activation code for the physical card will be sent along with the card.
- In the sandbox environment, the default activation code is 123456.
Updated 3 days ago