Skip to main content
WEBHOOK
otp_required
{
  "event": "OTP_REQUIRED",
  "session_id": "fb5aa994-ed1c-4c3e-b29a-b2a53222e584",
  "task_id": 25605,
  "external_user_id": "3dcbb19a-b2f1-4a7b-8792-d76027b627b3",
  "merchant": {
    "id": 10,
    "name": "Uber"
  },
  "data": {
    "card_id": "123456789",
    "metadata": {
      "reference_token": "abc123",
      "trace_id": "def456"
    }
  },
  "timestamp": 1710864923198
}

Documentation Index

Fetch the complete documentation index at: https://docs.knotapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Fired when a user needs to enter an OTP code to login to a merchant for the 1st time.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password. Use your client_id as the username and your secret as the password value.

Body

application/json
​
event
string

Name of the webhook event.

Example:

"OTP_REQUIRED"

​
session_id
string

Unique identifier for the session.

Example:

"fb5aa994-ed1c-4c3e-b29a-b2a53222e584"

​
task_id
integer

Unique identifier for the task.

Example:

25605

​
external_user_id
string

Unique identifier for the user.

Example:

"3dcbb19a-b2f1-4a7b-8792-d76027b627b3"

​
merchant
object
​
data
object
​
timestamp
integer

Unix timestamp of the webhook event in UTC.

Example:

1710864923198