Lightspark Strong Customer Authentication API is one of 22 APIs that Lightspark publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Strong Customer Authentication. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
16 operations
across 15 paths,
and defines 180 schemas.
It is described by OpenAPI 3.1.0, at version 2025-10-13.
Requests are made against a single base URL, https://api.lightspark.com/grid/2025-10-13.
The identity and technical contract details declared by the specification.
ScaLoginStartRequest
object
Selects which enrolled factor to start an SCA login with. The factor must already be enrolled (or, for SMSOTP, the phone verified).
1 property
1 required
PaymentEmbeddedWalletInfo
EurAccountInfoBase
object
3 properties
2 required
QuoteSourceType
string
Type of quote funding source
ScaFactorView
object
An enrolled Strong Customer Authentication factor.
3 properties
1 required
TotpEnrollmentConfirmRequest
object
The shared secret returned by the TOTP enrollment start, plus the first code the customer's authenticator app produces, submitted to confirm and finalize the T…
3 properties
3 required
RecordSecurityEventRequest
object
Records a client-side security event for the customer so Grid can maintain the customer's login-security state (SCA session revocation and failed-login lockout…
1 property
1 required
Error404
object
4 properties
3 required
GtqAccountInfoBase
object
4 properties
4 required
CadAccountInfoBase
object
4 properties
4 required
BaseWalletInfo
object
2 properties
2 required
GbpAccountInfoBase
object
3 properties
3 required
PaymentRail
string
The payment rail used for the transfer. Payment rails represent the underlying payment network or system used to move funds between accounts.
TotpFactorEnrollRequest
object
Start enrolling a time-based one-time-password (TOTP) authenticator factor.
1 property
1 required
OutgoingRateDetails
object
Details about the rate and fees for an outgoing transaction or quote. Note: counterpartyFixedFee is denominated in the receiving currency, so its equivalent va…
6 properties
6 required
Error409
object
4 properties
3 required
TwoFactorResetStartRequest
object
Selects which enrolled factor to reset via the liveness-gated recovery flow.
1 property
1 required
MyrAccountInfoBase
object
4 properties
4 required
Error400
object
4 properties
3 required
HtgAccountInfoBase
object
2 properties
2 required
IdrAccountInfoBase
object
5 properties
5 required
Error500
object
4 properties
3 required
HkdAccountInfoBase
object
4 properties
4 required
SwiftAccountInfoBase
object
6 properties
4 required
PaymentInstructions
object
3 properties
1 required
BasePaymentAccountInfo
object
1 property
1 required
BaseQuoteSource
object
1 property
1 required
KesAccountInfoBase
object
3 properties
3 required
ScaFactorEnrollStartOneOf
The factor-specific material needed to complete enrollment, keyed by type: a TOTP shared secret + provisioning URI, or the WebAuthn registration options for a…
TwoFactorResetStatus
object
The status of an in-progress 2FA reset, polled until it reaches a terminal value.
5 properties
3 required
UgxAccountInfoBase
object
3 properties
3 required
MxnAccountInfoBase
object
2 properties
2 required
InrAccountInfoBase
object
Required fields depend on the selected paymentRails: - NEFT: accountNumber, ifsc, rail - RTGS: accountNumber, ifsc, rail - UPI: vpa
6 properties
1 required
PolygonWalletInfo
object
2 properties
2 required
Error429
object
4 properties
3 required
BeneficiaryTrustConfirm
object
The result of a confirm-trust / confirm-untrust call. trusted is true after a successful trust and false after a successful untrust.
1 property
1 required
PasskeyEnrollmentConfirmResponse
object
The enrolled passkey factor returned after a successful confirmation.
2 properties
2 required
Quote
object
18 properties
13 required
MwkAccountInfoBase
object
3 properties
3 required
Error401
object
4 properties
3 required
ScaLoginComplete
object
The status of a completed SCA login session.
1 property
1 required
SolanaWalletInfo
object
2 properties
2 required
ScaFactorConfirmResponseOneOf
The enrollment result, keyed by type.
RwfAccountInfoBase
object
3 properties
3 required
SlvAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: bankAccountType, accountNumber - MOBILEMONEY: phoneNumber
5 properties
1 required
TotpEnrollmentStart
object
The shared secret a customer's authenticator app needs to enroll a TOTP factor. Returned by POST /sca/factors for a TOTP request; the customer scans totpUri (a…
4 properties
4 required
PhpAccountInfoBase
object
3 properties
3 required
GhsAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
AedAccountInfoBase
object
3 properties
2 required
ScaAuthorization
object
Proof that satisfies an ScaChallenge. Provide exactly one of code (for SMSOTP / TOTP) or passkeyAssertion (for PASSKEY). When supplying a passkeyAssertion, ori…
3 properties
TwoFactorResetStart
object
The reset handle plus the opaque liveness handles a caller relays to the end-user device to complete the liveness check. resetId threads the ceremony together…
4 properties
1 required
EthereumWalletInfo
object
2 properties
2 required
TronWalletInfo
object
2 properties
2 required
PaymentAccountType
string
Type of payment account or wallet
TotpEnrollmentConfirmResponse
object
The one-time recovery codes issued once a TOTP factor is enrolled. These are shown to the customer only once; store them somewhere safe to recover access if th…
2 properties
2 required
CnyAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
CounterpartyInformation
object
Additional information about the counterparty, if available and relevant to the transaction and platform.
DestinationType
string
Type of payment destination
BeneficiaryTrustConfirmRequest
object
Confirms trusting or untrusting a beneficiary by submitting the SCA proof. Carries the same proof fields as an ScaAuthorization (code for SMSOTP / TOTP, or pas…
4 properties
JmdAccountInfoBase
object
5 properties
5 required
TwoFactorResetCompleteRequest
object
Optional body for completing a 2FA reset. Only needed when resetting the SMSOTP factor to a new phone number; omit the body entirely otherwise.
1 property
NgnAccountInfoBase
object
3 properties
3 required
BaseDestination
object
1 property
1 required
PaymentLightningInvoiceInfo
BeneficiaryTrustStart
object
The SCA challenge (if any) a caller authorizes to finish trusting (or untrusting) a beneficiary. The beneficiary is identified by its externalAccountId, so the…
1 property
TzsAccountInfoBase
object
3 properties
3 required
PasskeyEnrollmentStart
object
Opaque WebAuthn registration options relayed to the end user's device to enroll a passkey factor. Grid performs no crypto; pass options to the device's WebAuth…
4 properties
4 required
ThbAccountInfoBase
object
4 properties
4 required
XafAccountInfoBase
object
4 properties
4 required
ScaChallenge
object
A Strong Customer Authentication challenge that must be satisfied before a money-movement operation can complete. This object is only present when the customer…
7 properties
4 required
PaymentEthereumWalletInfo
BdtAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
6 properties
2 required
ScaLoginStart
object
The factor-specific material a customer needs to complete an SCA login. Each factor surfaces only the fields it issues: SMSOTP carries challengeId and expiresA…
6 properties
1 required
RealtimeFundingQuoteSource
UsdAccountInfoBase
object
3 properties
3 required
XofAccountInfoBase
object
4 properties
4 required
PkrAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: accountNumber, bankName - MOBILEMONEY: bankName, phoneNumber
5 properties
2 required
EgpAccountInfoBase
object
Required fields depend on the selected paymentRails: - BANKTRANSFER: bankName, iban - MOBILEMONEY: bankName, phoneNumber
4 properties
2 required
ScaFactor
string
A Strong Customer Authentication factor. | Factor | Description | |--------|-------------| | SMSOTP | One-time code sent by SMS to the customer's verified phon…
SparkWalletInfo
object
2 properties
2 required
DkkAccountInfoBase
object
3 properties
2 required
ZmwAccountInfoBase
object
3 properties
3 required
VndAccountInfoBase
object
4 properties
4 required
ScaLoginCompleteRequest
object
Completes an SCA login by submitting the proof for the started factor. Carries the same proof fields as an ScaAuthorization (code for SMSOTP / TOTP, or passkey…
5 properties
1 required
ScaFactorEnrollRequestOneOf
Which SCA factor to begin enrolling, selected by type. SMSOTP is not enrollable (it uses the customer's verified phone), so only TOTP and PASSKEY are valid her…
Currency
object
4 properties
Error423
object
4 properties
3 required
BwpAccountInfoBase
object
3 properties
3 required
PasskeyFactorEnrollRequest
object
Start enrolling a WebAuthn passkey factor.
1 property
1 required
ScaFactorConfirmRequestOneOf
The proof that finalizes enrollment, keyed by type: the TOTP shared secret + code, or the passkey origin + credential.
PasskeyEnrollmentConfirmRequest
object
The WebAuthn credential a device produced for a passkey registration challenge, submitted to enroll the passkey factor.
3 properties
3 required
ZarAccountInfoBase
object
3 properties
3 required
ScaFactorList
object
The Strong Customer Authentication factors a customer has enrolled.
1 property
1 required
RecordSecurityEventResponse
object
The customer's login-security state after recording the event, so the integrator can surface a lockout to the end user.
4 properties
3 required
SgdAccountInfoBase
object
4 properties
3 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs Lightspark publishes across the network.
