Webhook Events

Use webhooks to receive real-time notifications when events happen in your account.

Configuring Endpoints

You can configure your webhook URL in the Settings tab of your Merchant Dashboard. All events are sent via HTTP POST with a JSON payload.

Payload Structure

{
  "id": "evt_7h2u...",
  "type": "transaction.succeeded",
  "created": 1710787200,
  "data": {
    "reference": "sandbox_tx_102",
    "amount": 1000.00,
    "status": "success"
  }
}

Retry Policy

If your server returns anything other than a `2xx` status code, SimulatePay will attempt to redeliver the event up to 12 times using exponential backoff.

1 min 5 min 15 min ...