Skip to content
Security Settings

Get Authenticator Binding QR Code

Gets the QR code content and secret the Client needs to bind a third-party authenticator (a TOTP app such as Google Authenticator or Microsoft Authenticator). The Broker App renders qr_code_url as a QR code for the Client to scan and shows secret for manual entry.

Binding flow: the Client first completes SMS verification of the bound mobile number, then the Broker App calls this operation to show the QR code. After adding the account in the authenticator, the Client submits a code it generates through Set Authenticator Two-Factor Verification to finish turning it on.

If the Client has already bound an authenticator, business code 402017 is returned. Show message and end the binding flow.

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

GEThttps://api.lbkrs.com/v1/account/totp/qrcode

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Authenticator Binding QR Code” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
qr_code_urlstring

QR code content. The Broker App encodes this string into a QR code as is

secretstring

Authenticator secret for manual entry when the Client cannot scan the QR code

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs