Skip to main content
POST
Setup 2FA
This endpoint requires a valid Bearer token in the Authorization header.
Initiates two-factor authentication setup for the merchant’s account. Returns a TOTP secret and an otpauth:// URI that can be rendered as a QR code for authenticator apps like Google Authenticator or Authy. After scanning the QR code, the merchant must call Verify 2FA with a valid code to complete the setup.

Example Response (200)

The secret is shown only once during setup. If the merchant loses it, they will need to disable and re-enable 2FA.

Error Responses

409 Already Enabled