Skip to content
Settle Chnl Acct

Update Whale Account

Edit a settlement-channel bank account. The field structure matches "Add settlement-channel account", with an additional id to locate the target record.

Request parameters

  • Required: id (account ID)
  • The remaining fields follow "Add settlement-channel bank account". See each field's definition for its format, value range, default behavior, and business meaning.

Business notes

id identifies the settlement-channel bank account to edit; the remaining fields (settlement channel, account name, bank account, region, currency, etc.) have the same meaning as in the create endpoint.

Risk warning

This operation changes the bank-account information used by a settlement channel and may affect fund settlement and transfers. Confirm the target account and parameters before calling.

Result

On success the settlement-channel bank account is updated; see the 200 response definition for the returned content.

PUThttps://b-api.lbkrs.com/atm/whale/account

Authorization

AuthorizationstringheaderRequired

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

Permission

atm.settle_chnl_bank_acct_operation

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

Request body application/json

idstringrequired

Record ID

settlement_channelstringrequired

Settlement channel

main_accountsarray<object>
Child attributes
namestring

Main account name

typestring

Main account type

accountstring

Main account number

scenariostring

Business scenario

account_namestringrequired

Account name

bank_accountstringrequired

Bank account number

bank_idstring

Card issuing bank

regionstringrequired

Country/Region

bank_addrstringrequired

Bank address

withdraw_typesarray<object>
Child attributes
namestring

Settlement channel

typesstring

Withdrawal method

remarkstring

Remark

currencystringrequired

Currency

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

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