For Developers

Webhook

Төлем статус өзгергенде хабарламалар

AiPay төлем статусы өзгерген сайын HTTP POST жібереді. Company settings-те notif_url орнатыңыз.

Орнату

1. 1Dashboard-те company settings-те webhook URL орнатыңыз
2. 2AiPay әр статус өзгергенде POST жібереді
3. 3HTTP 200 жауап беріңіз
4. 4200-ден өзгеше жауап берілсе, AiPay retry жасайды

Invoice оқиғасы мысалы

{
  "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_type": "device_status",
  "data": {
    "pos_id": "uuid-here",
    "status": "working"
  }
}

Ұсыныстар

• —Webhook-ты асинхрон өңдеп, тез 200 қайтарыңыз
• —Идемпотенттілік қосыңыз
• —Барлық webhook-ты логтаңыз
• —Sandbox-та тексеріңіз