Sign in

v1

latestOpenAPI 3.1.02026-07-26165182724.7 KB
Business Enrollment

Start TOTP enrollment (business)

Returns a TOTP secret and an otpauth:// provisioning URI for a business. Render the URI as a QR code (or expose the base32 secret) so the operator can add the entry to their authenticator app, then call /business/resume/setup-two-factor with the first 6-digit code. — Requires 'totp' to be present in the application's allowedScaMethods.

post/business/start/setup-two-factor

Request body

businessIdstring uuid required

Example request

{
  "businessId": "8b1d5f2a-3c4e-4a6b-9f0d-7e2c1a4b5d6e"
}

Response

TOTP secret and provisioning URI.

secretstring

Raw TOTP secret.

secretBase32Encodedstring

Base32-encoded TOTP secret for authenticator apps.

totpUristring

otpauth://totp/... URI; encode as a QR code on the client.