Skip to content
Longport WhaleLongport Whale
Bank Account Management

Edit Bank Card

Update a customer's withdrawal bank card as an administrator.

Request parameters

  • Required: id (bank card ID), region (region code), name_en (English name), account (bank account), country (country name), bank_en (bank English name)
  • Optional: bank_id (bank ID), swift_code (SWIFT code), account_type (account type, e.g. ALL/HKD/USD), address (address), bank_code (bank code, for HK banks), fps_id (FPS ID: phone/email/FPS ID), review_urls (review document upload URLs), account_no (account number)
  • The admin frontend always sends bank_id (chosen from the banks of the selected region) and review_urls (upload keys of the bank-card proof files, not signed URLs). It also sends member_id, name (same value as name_en), account_channel, remark, front_payload, and audit_frontend_resource.
  • id is the id of the card row in the atm_withdraw_cards list. The admin frontend service definition marks this endpoint as discard.
  • See the field definitions for each field's format, allowed values, and business meaning.

Business notes

The update changes the customer's withdrawal payee account; confirm the changes are correct.

Risk warning

This operation may change real funds, positions, or transaction state. Confirm the target record and parameters before calling.

Returns

On success returns the updated card; see the 200 response for field definitions.

POSThttps://b-api.lbkrs.com/v1/portfolio/withdraw/card/update/by/admin

Authorization

AuthorizationstringheaderRequired

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

Permission

b2b_withdraw.update_withdrawal_card

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

Request body application/json

idintegerrequired

Bank card id (for update). Specifies Bank card id (for update). This field is required.

bank_idintegerrequired

Bank id. Specifies Bank id.

regionstringrequired

Region code. Specifies Region code. This field is required.

name_enstringrequired

English name. Specifies English name. This field is required.

accountstringrequired

Bank account. Specifies Bank account. This field is required.

swift_codestring

Swift code. Specifies Swift code.

account_typestring

Account type, e. Values come from a backend data dictionary (maintained dynamically), not a fixed enum; use the options the service actually returns.

countrystringrequired

Country name. Specifies Country name. This field is required.

addressstring

Address. Specifies Address.

bank_enstringrequired

Bank English name. Specifies Bank English name. This field is required.

bank_codestring

Bank code (for HK banks). Specifies Bank code (for HK banks).

fps_idstring

FPS id. Specifies FPS id.

review_urlsarray<string>required

Audit data upload urls. Specifies Audit data upload urls.

member_idstring

Customer ID that owns the card. The admin frontend sends it from the card record.

namestring

Account holder name. The admin frontend sets it to the value of name_en.

account_channelstring

Account channel of the current admin session. The admin frontend fills it in automatically.

remarkstring

Customer remark.

front_payloadobject

Field-change summary for the audit log (type is data_diff), built by the admin frontend.

audit_frontend_resourceobject

Audit context submitted by the admin frontend.

Responses

HTTP 200The request was processed successfully. data is the result.
Standard response envelopecodemessagedata
dataobjectdata structure
idinteger

Bank account id. Specifies Bank account id.

iconstring

Bank icon. Specifies Bank icon.

HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs