For Developers

Webhook

Мгновенные уведомления при смене статуса оплаты

При каждом изменении статуса оплаты AiPay отправляет HTTP POST запрос на ваш URL. Настройте notif_url в настройках компании в Dashboard.

Настройка

1. 1Укажите webhook URL (notif_url) в настройках компании в Dashboard
2. 2AiPay будет отправлять POST-запросы на этот URL при каждом событии
3. 3Отвечайте HTTP 200 для подтверждения получения
4. 4При ответе отличном от 200 AiPay выполнит retry с exponential backoff

Пример — Invoice Event

{
  "event_type": "invoice_update",
  "timestamp": "2026-06-07T12:00:00Z",
  "user_id": "uuid-here",
  "data": {
    "invoice_id": "uuid-here",
    "status_code": 9,
    "status": "paid",
    "amount": 5000,
    "account": "+770****6543",
    "account_name": "Иван Иванов",
    "message": "Order #123"
  }
}

Пример — Device Event

{
  "event_type": "device_status",
  "data": {
    "pos_id": "uuid-here",
    "status": "working"
  }
}

Рекомендации

• —Обработайте webhook асинхронно и ответьте 200 быстро
• —Реализуйте идемпотентность — AiPay может отправить событие дважды
• —Логгируйте все webhook для отладки
• —Тестируйте в sandbox до перехода на production