Strong Customer Authentication

Complete a 2FA reset

Changed on

Complete a 2FA reset once liveness has passed, clearing the lost factor so the customer can re-enroll.

The body is required and must carry the end user's endUserIpAddress. For an SMS_OTP reset, also supply the new mobile number — completing the reset enrolls it as the customer's number; other factors need no mobile.

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.

post/sca/factors/reset/{resetId}/complete

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/sca/factors/reset/{resetId}/complete
  • Auth
    HTTP basic

Request body

endUserIpAddressstring required

The IP address of the end user's device completing this reset, recorded against the reset by the SCA provider. Supply the customer's address, not your server's — it feeds the provider's risk assessment of the recovery.

Example request

{
  "endUserIpAddress": "203.0.113.42",
  "mobile": {
    "countryCode": "+1",
    "number": "4155550123"
  }
}

Response

Reset completed; no content is returned.

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • warning

      added the new PURCHASE_CARD_LIMIT_REACHED enum value to the response property for the response status