> ## Documentation Index
> Fetch the complete documentation index at: https://docs.check.et/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks (Coming Soon)

> Get notified when verifications complete

<Note>
  Webhooks are on our roadmap. In the meantime, poll `GET /verifications` or verify synchronously in your order flow.
</Note>

## Planned design

When webhooks ship, you'll be able to register an endpoint URL in the dashboard. Check.et will POST a signed payload when a verification completes:

```json theme={null}
{
  "event": "verification.completed",
  "data": {
    "id": 9812,
    "success": true,
    "bank": "cbe",
    "amount": 1350.00,
    "transaction_number": "FT25161234567"
  },
  "timestamp": "2025-06-10T14:32:00+03:00"
}
```

## Current workaround

Call `POST /verify` synchronously in your checkout or order confirmation flow. Verification typically completes within 1–3 seconds for supported banks.

```js theme={null}
// In your order handler
const verification = await verifyPayment({
  bank: order.bank,
  transaction_number: order.ref,
  account_number: process.env.CBE_ACCOUNT,
})

if (!verification.success) {
  return res.status(400).json({ error: "Payment not confirmed" })
}

await fulfillOrder(order.id)
```