Start an SCA login
Changed onBegin an SCA login for the customer with the chosen factor, opening the end-user SCA session (an exemption gating read / account access beyond the per-transaction window). Returns factor-specific material: SMS_OTP dispatches a code and returns a challengeId + expiresAt; TOTP returns only the factor (the customer reads the code from their app); PASSKEY returns WebAuthn passkeyOptions. Complete with POST /sca/login/complete.
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.
Request
- Base URLhttps://api.lightspark.com/grid/2025-10-13
- URLhttps://api.lightspark.com/grid/2025-10-13/sca/login/start
- AuthHTTP basic
Request body
Response
SCA login started; factor-specific material is returned.
Example response
{
"expiresAt": "2025-10-03T12:05:00Z",
"allowedOrigins": [
"https://app.example.com"
],
"relyingPartyId": "app.example.com"
}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