Device Verification

1672

Progressive Leasing requires that all new and returning customers verify their phone number by receiving and clicking an SMS link. This can be accomplished by calling the POST /v1/application/verification endpoint as shown below.

curl --request POST \
     --url https://www.progressivelp.com/Progressive.B2BAPI.Orchestrator/api/v1/application/verification \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
{
     "phoneNumber": "5552224321",
     "languagePreference": "en",
     "destinationUrl": "http://example.com/",
     "createdBy": "CommerceAPI"
}
'

If deviceVerificationId is returned, then the SMS was successfully sent. The merchant can start polling to see if the customer has completed their verification, using the GET /v1/application/verification endpoint as shown below. Progressive recommends calling our service every 5 seconds for up to 300 seconds.

curl --request GET \
     --url 'https://www.progressivelp.com/Progressive.B2BAPI.Orchestrator/api/v1/application/verification/?verificationId=123' \
     --header 'Accept: application/json'
'

If isDeviceVerified returns True, then the customer is safe to move forward with the application. If isDeviceVerified returns False after 300 seconds, the customer must call Progressive Leasing to continue.