Skip to content
Bank Account Management

Verify Withdrawal Card

Validate a withdrawal bank card and return the validation result.

Request parameters

  • Required: member_id (user ID), region (region code), account (account to validate)
  • Optional: id (bank card ID, pass when editing, omit when creating), bank_code (bank code)
  • See the field definitions for each field's format, allowed values, and business meaning.

Returns

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

POSThttps://b-api.lbkrs.com/atm/withdraw/card/verify

Authorization

AuthorizationstringheaderRequired

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

Permission

b2b_withdraw.add_withdraw_card

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

Request body application/json

idinteger

Bank card id (pass when editing, omit when adding). Specifies Bank card id (pass when editing, omit when adding).

member_idintegerrequired

Member id. Specifies Member id. This field is required.

member_id is the customer ID. It differs from the securities account number account_no and the internal securities account ID aaid; one customer can have multiple securities accounts.

bank_codestring

Bank code. Specifies Bank code.

regionstringrequired

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

accountstringrequired

Account number to verify. Specifies Account number to verify. This field is required.

Responses

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

Account error reason. Specifies Account error reason.

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