Skip to content
Identity Verification

Check Email Verification Code

Checks the email 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/email/send_code first. email (before encryption) and type must match the values used when sending the code. Encrypt email before sending it, and pass the timestamp used for encryption in the x-timestamp header.

When type is reset_trade_password or set_trade_password, pass the credential to POST /v2/member/trade/reset_password or POST /v2/member/trade/set_password respectively.

Features that use this operation: resetting and setting the trade password, binding or changing the email, verifying the email before changing the phone number, and closing the account. Account opening contact verification and email registration and login 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_email

Parameters

x-timestampstringheaderRequired

Millisecond timestamp string. It must match rd in the encrypted field

Request body application/x-www-form-urlencoded

codestringrequired

Verification code received by the Client

emailstringrequired

Encrypted email address. Never send it in plaintext. Use the same encryption as card_id in “Verify Account-Opening ID Number”, with the x-timestamp header as rd

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
  • change_email - Verify the current email before changing it
  • bind_email - Bind an email
  • verify_email - Verify an email
  • change_mobile - Verify the email before changing the phone number
  • identity_verify - Verify identity before closing the account

Responses

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

Verification credential issued after the check succeeds

member_existboolean

Whether the email is already associated with another user. It is used in the bind email flow and can be ignored in trade password flows

Whale Docs