GuideAPI Reference

📬 Webhooks and Events

Webhooks allow your system to react to events that happen in Straqa, like a payment success or a ticket purchase.

How it Works

  1. You provide a webhook URL in your dashboard

  2. Straqa sends an HTTP POST request to your URL when an event occurs

  3. Your server processes the payload and responds with 200 OK

Common Webhook Events

  • payment.success

  • payment.failed

  • ticket.purchased

  • shipment.updated

  • order.fulfilled

Example Payload

{
  "event": "payment.success",
  "data": {
    "reference": "txn_001",
    "amount": 5000,
    "currency": "NGN",
    "customer": {
      "email": "[email protected]"
    }
  }
}

🔒 Always verify webhook signatures to ensure authenticity.