/bff/account/verify-signup

Dual-channel verification for the new signup flow. On success, materialises the cas__user, marks the pending request as verified, and sets a session cookie in the same response so the caller can redirect straight to /. Returns a discriminated-union error payload for every failure mode so the UI can render precise copy.

AccountpostBffAccountVerify-signup

Parameters

JSON body

Request body

application/json

object | object

One of 2:

Variant 1

by"code"Required

emailstringRequired

E-mail address used in the pending signup.

codestringRequired

6-digit code from the confirmation e-mail.

Length: 6–6

Variant 2

by"token"Required

tokenstringRequired

32-char token from the confirmation link.

Length: 32–32

Response schema

1 status code documented

200Success

One of 6:

Variant 1

status"ok"Required

Variant 2

status"wrong_code"Required

attemptsLeftnumberRequired

Variant 3

status"locked"Required

Variant 4

status"expired"Required

Variant 5

status"not_found"Required

Variant 6

status"already_verified"Required

Response example

application/json

{
  "status": "ok"
}

Request example

POST /bff/account/verify-signup

post

curl -X POST "https://api.bizkithub.com/bff/account/verify-signup" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "by": "code",
  "email": "example_email",
  "code": "example_code"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key