Bestätigungscode-Kanal erfolgreich

POST

Das Ereignis verify_code.channel.success wird ausgelöst, wenn ein bestimmter Kanal den Bestätigungscode erfolgreich verarbeitet hat.

Webhook-Benachrichtigungen

Authorizations

• token

Request Body ^required

Media type application/json

object

id

Eindeutige Entitäts-UUID

string

/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

api_version

Version der Datenstruktur der Meldung

string

name

Name des Webhook-Ereignisses

string

created_at

Zeitstempel, wann die Entität vom Benutzer zum System hinzugefügt wurde

integer

attempt_total

Gesamtzahl der Zustellversuche von Benachrichtigungs-Webhooks

integer

>= 1 <= 4

attempt_number

Aktuelle Nummer des Webhook-Benachrichtigungsversuchs

integer

>= 1

notification_task_id

Notification task identifier (request identifier)

string format: uuid

name

Allowed values: verify_code.channel.success

data

Data for verify_code.channel.sent, verify_code.channel.success and verify_code.channel.failed events

object

id

Verify code ID (UUID)

string

user_id

User ID

integer

phone

Phone number

string

routing_strategy

Routing strategy configuration

Array<object>

object

channel

string

Allowed values: telegram sms

timeout_sec

Timeout in seconds. Only applicable for the telegram channel.

integer

sender_id

string

status

Verify code status

integer

delivered_channel

Channel that delivered the code

string | null

cost

Cost in cents

integer | null

currency

Currency code

string | null

code

Verification code

string | null

code_length

Code length

integer | null

payload

Custom payload

string | null

created_at

Creation timestamp

integer

updated_at

Last update timestamp

integer

history

Processing history

Array<object>

object

id

string

channel

string

status

integer

processed_at

integer

external_id

string

is_code_deleted

Whether the verification code has been deleted from storage after being sent.

boolean

channel

Channel-specific processing details

object

id

History entry ID

string

channel

Channel type

string

Allowed values: telegram sms

status

Channel processing status

integer

processed_at

Processing timestamp

integer

external_id

External provider ID

string | null

error

Error message if failed

string | null

cost

Cost for this channel in cents

integer | null

Examples

Example success

Verify Code Channel Success Event

Event sent when a specific channel has confirmed successful delivery of the verification code

{
  "id": "b3e4f5a6-7c8d-4e9f-0a1b-2c3d4e5f6a7b",
  "api_version": "2022-05-25",
  "name": "verify_code.channel.success",
  "created_at": 1735689575,
  "attempt_total": 3,
  "attempt_number": 1,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "user_id": 12345,
    "phone": "+4915112345678",
    "routing_strategy": [
      {
        "channel": "telegram",
        "timeout_sec": 30,
        "sender_id": "LOX24"
      },
      {
        "channel": "sms",
        "timeout_sec": 60,
        "sender_id": "LOX24"
      }
    ],
    "status": 10,
    "delivered_channel": "telegram",
    "cost": 5,
    "currency": "EUR",
    "code": "1234",
    "code_length": 4,
    "payload": "session_abc123",
    "created_at": 1735689540,
    "updated_at": 1735689575,
    "history": [
      {
        "id": "a1b2c3d4-d5e6-7890-abcd-ef1234567890",
        "channel": "telegram",
        "status": 10,
        "processed_at": 1735689570,
        "external_id": "tg_msg_001"
      }
    ],
    "is_code_deleted": false,
    "channel": {
      "id": "a1b2c3d4-d5e6-7890-abcd-ef1234567890",
      "channel": "telegram",
      "status": 10,
      "processed_at": 1735689570,
      "external_id": "tg_msg_001",
      "error": null,
      "cost": 5
    }
  },
  "notification_task_id": "66cbf195-fb99-4fb9-8a5c-5e43f74ee864"
}

Responses

200

Webhook empfangen

400

Ungültige Struktur der Webhook-Anfrage

401

Webhook-Anfrage nicht autorisiert

403

Webhook-Zugang untersagt

404

Webhook-Zugang untersagt

500

Server-Fehler