Merchant Authentication
CREDENTIALS_REQUIRED
Triggered when a user needs to enter login credentials to login to a merchant.
Request example
{
"event": "CREDENTIALS_REQUIRED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
CREDENTIALS_FAILED
Triggered when the login credentials used to login to a merchant are incorrect.
Request example
{
"event": "CREDENTIALS_FAILED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
OTP_REQUIRED
Triggered when a user needs to enter an OTP code to login to a merchant.
Request example
{
"event": "OTP_REQUIRED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
OTP_FAILED
Triggered when the OTP code used to login to a merchant is incorrect.
Request example
{
"event": "OTP_FAILED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
LOGIN_APPROVAL
Triggered when a user needs to approve the login to a merchant via a push notification, text message, or similar from a merchant.
Request example
{
"event": "LOGIN_APPROVAL",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
QUESTIONS_REQUIRED
Triggered when a user needs to provide answers to security questions.
Request example
{
"event": "QUESTIONS_REQUIRED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
QUESTIONS_FAILED
Triggered when the answers to security questions are incorrect.
Request example
{
"event": "QUESTIONS_FAILED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789"
},
"timestamp": 1710864923198
}
AUTHENTICATION_FAILED
Triggered when the authentication to a merchant failed.
Request example
{
"event": "AUTHENTICATION_FAILED",
"session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
"task_id": 25605,
"external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
"merchant": {
"id": 11,
"name": "Uber"
},
"data": {
"card_id": "123456789",
"reason": "otp timeout"
},
"timestamp": 1710864923198
}
Updated 8 days ago