Add Bank Card

Adds a withdrawal bank card for the given securities account.

Request parameters

Required: account_no, bank_id, region, bank_en, name, name_en, account, account_type, country
Optional: swift_code, address, remark, bank_code, need_certification, fps_id, review_urls
When certification is needed, pass the certification image keys from the file upload API in review_urls.

Business notes

name / name_en must exactly match the account holder's KYC real name / English name, or the call returns 500 2031041 (name not match).
A new card must be certified (status=2) before it can be used for withdrawals.

POSThttps://b-api.lbkrs.com/v1/whaleapi/portfolio/withdraw/card

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

lb_account_withdraw_card.add

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

bank_idintegerrequired

region bank id

regionstringrequired

Region

bank_enstringrequired

Bank name ,maximum of 30 characters

namestringrequired

User name. Must exactly match the account holder's KYC real name (real_name), or the call returns 2031041 (name not match).

name_enstringrequired

User English name. Must exactly match the account holder's KYC English name (en_name).

accountstringrequired

User Bank Account ,maximum of 20 characters

swift_codestring

swift_code-8 or 11 characters

account_typestringrequired

Account Type enum:ALL,USD,HKD. Account Type enum:ALL,USD,HKD...

countrystringrequired

Country ,maximum of 50 characters

addressstring

Address maximum of 50 characters

remarkstring

Remark

bank_codestring

Bank Code

need_certificationboolean

Need Certification

fps_idstring

Fps Id

review_urlsarray<string>

Certification file keys. The keys of certification images obtained from the file upload API; pass a non-empty list when need_certification is true.

account_nostringrequired

Account No

account_no is the securities account number (such as L6VQEU00121996). It differs from the customer ID member_id and the internal securities account ID aaid.