Webhook Setup & Security

Overview

Webhooks enable real-time event notifications from the WaaS platform to your application.

Supported Events:

• account.upgrade.status - Account tier upgrade results
• transaction.inflow - Successful credit/inflow notifications

---

Setup Requirements

1. Configure Webhook Endpoint

Provide Access Bank with your webhook URL:

• Must be HTTPS (HTTP not allowed)
• Must return 200 OK within 5 seconds
• Must handle POST requests with JSON payload

Example: https://your-domain.com/webhooks/waas

---

Webhook Payload Structure

All webhooks use this standard structure:

{
  "event_id": "evt_abc123",
  "event_type": "account.upgrade.status",
  "timestamp": "2025-02-11T14:30:00Z",
  "data": {
    // Event-specific data
  },
  "metadata": {
    "environment": "production"
  }
}

---