Skip to content
Identity Verification

Send Email Verification Code

Sends a verification code to the Client's email for account security flows that require email verification. Complete human verification first, in the same way as for POST /v1/auth/send_code, and put the result in captcha. Encrypt email before sending it, and pass the timestamp used for encryption in the x-timestamp header.

After the code is sent, ask the Client to enter it, then call POST /v1/member/check_email with the same type to check it and obtain verify_credentials.

Features that use this operation:

  • Account › Trade password › Reset trade password (reset_trade_password): email verification when the Client has no bound phone number
  • Account › Trade password › Set trade password (set_trade_password): email verification when the Client has no bound phone number
  • Account › Contact details › Bind email, change email, verify email (bind_email, change_email, verify_email)
  • Account opening contact verification and account-opening information changes, as well as email registration, login, and login password recovery before sign-in, also use this operation, but those flows are outside TradingAPI

401043 means human verification failed; handle it in the same way as for sending SMS codes. For other failures, show message.

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

POSThttps://api.lbkrs.com/v1/auth/email/send_code

Parameters

x-timestampstringheaderRequired

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

Request body application/x-www-form-urlencoded

captchaobjectrequired

Human verification result. Send only the field for the verification provider used in this attempt. When the provider's switch field in the human verification configuration (tencent_switch or google_switch) is true, the server has turned off human verification for that provider; send an empty object for it, such as {"tencent": {}}.

Child attributes
tencentobject

Result from Tencent Cloud Captcha

Child attributes
ticketstring

The ticket returned after successful verification

rand_strstring

The random string randstr returned after successful verification

tencent_idstring

Captcha AppId used for this attempt, taken from tencent_ids in the human verification configuration

sidstring

The session ID sid returned after successful verification

googleobject

Result from Google reCAPTCHA Enterprise

Child attributes
tokenstring

Token returned by the verification

actionstring

Action passed when running the verification. It is the same as type in the request

site_keystring

Decrypted site key, which is the plaintext of google_key in the human verification configuration

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

Responses

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

No business fields

No nested fields

Whale Docs