Webhooks

Receive real-time notifications when events occur in your account.

Events

• ORDER_CREATED — New order placed
• ORDER_COMPLETED — Order finished successfully
• ORDER_CANCELLED — Order was cancelled
• SMS_RECEIVED — New SMS message received
• PAYMENT_RECEIVED — Wallet deposit confirmed
• BALANCE_LOW — Wallet balance below threshold

Payload

{
  "event": "SMS_RECEIVED",
  "data": {
    "orderId": "clxxx...",
    "code": "123456",
    "message": "Your verification code is 123456"
  },
  "timestamp": 1720185600000
}

Headers

X-AltiviaCloud-Event: SMS_RECEIVED
X-AltiviaCloud-Signature: whsec_your_webhook_secret
Content-Type: application/json

Configure webhooks in your Dashboard → Webhooks.