Skip to content
Identity Verification

Check SMS Verification Code

Checks the SMS verification code entered by the Client and, when it is valid, returns verify_credentials as the identity verification credential for the next sensitive operation. Call POST /v1/auth/send_code first. country_code, mobile, and type must match the values used when sending the code.

How the credential is used depends on type:

  • reset_trade_password - Pass it to POST /v2/member/trade/reset_password
  • set_trade_password - Pass it to POST /v2/member/trade/set_password
  • totp - Pass it to POST /v1/account/totp/setting
  • trade_auth_2fa - After the check succeeds, submit the same code to POST /v1/member/trade/auth_two_factors

This operation is used by the same features as sending SMS codes, including resetting and setting the trade password, SMS two-factor verification for trade unlock, turning the token on or off, changing the phone number or email, and closing the account. Account opening contact verification and login password recovery before sign-in also use it, but those flows are outside TradingAPI.

If the check fails, show message and let the Client re-enter the code or request a new one. When the credential is no longer valid, send and check a new code. The server determines how long the credential remains valid.

When you call this operation through WhaleCore requestService(), you do not need to set requiresTradeToken to true.

POSThttps://api.lbkrs.com/v1/member/check_mobile

Request body application/json

codestringrequired

Verification code received by the Client

country_codestringrequired

International dialing code of the phone number, without +, such as 852

mobilestringrequired

Client's phone number without the dialing code. It must match the number used when sending the code

typestringrequired

Purpose of the code. Send the same value when sending and checking the same code:

  • reset_trade_password - Reset the trade password
  • set_trade_password - Set the trade password
  • trade_auth_2fa - SMS two-factor verification for trade unlock
  • totp - Verify the phone before turning the token on or off
  • change_mobile - Verify the current phone before changing the phone number
  • change_email - Verify the phone before changing the email
  • identity_verify - Verify identity before closing the account

Responses

HTTP 200The request succeeded. The response body contains the result of the “Check SMS Verification Code” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
verify_credentialsstring

Verification credential issued after the check succeeds

Whale Docs