Confirm SCA factor enrollment
Changed onFinalize the factor enrollment started by POST /sca/factors. The request body is discriminated by type: for TOTP, submit the shared secret from the start call plus the first code; for PASSKEY, submit the WebAuthn credential the device produced plus the origin it was produced against. The threaded secret/credential binds the confirmation to its enrollment, so no separate id is needed.
A TOTP confirmation returns one-time recovery codes (shown once); a passkey confirmation returns the enrolled factor.
This endpoint is only meaningful for customers in a region where SCA is required (e.g. EU). For customers outside SCA-regulated regions, this returns 409.
In sandbox, the TOTP code is always 000000.
Request
- Base URLhttps://api.lightspark.com/grid/2025-10-13
- URLhttps://api.lightspark.com/grid/2025-10-13/sca/factors/confirm
- AuthHTTP basic
Request body
Example request
{
"code": "000000"
}Response
Factor enrolled; the factor-specific result is returned.
Example response
{
"recoveryCodes": [
"ABCD-EFGH-IJKL",
"MNOP-QRST-UVWX"
]
}Changes
- info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status
- info
- warning
added the new
PURCHASE_CARD_LIMIT_REACHEDenum value to theresponse property for the response status
- warning