Webhooks

Real-time event notifications

How Webhooks Work

Webhooks allow your application to receive real-time notifications when events happen in your DunePay account. Instead of polling our API, we'll send HTTP POST requests to your endpoint whenever an event occurs.

1

Event Occurs

Transaction completes, KYC approved, etc.

2

We Send POST

JSON payload sent to your endpoint

3

You Respond

Return 200 OK to acknowledge

Available Events

transaction.created
New transaction initiated
transaction.completed
Transaction successfully completed
transaction.failed
Transaction failed
kyc.approved
KYC verification approved
kyc.rejected
KYC verification rejected
wallet.updated
Wallet balance changed
payout.completed
Payout processed
refund.processed
Refund completed

Webhook Payload Example

{
  "id": "evt_1234567890",
  "type": "transaction.completed",
  "created": 1708000000,
  "data": {
    "transaction_id": "tx_abc123",
    "amount": 100.00,
    "currency": "USD",
    "status": "completed"
  }
}

Webhook Security

  • Signature Verification: Each webhook includes a signature in the header for verification
  • Automatic Retries: We retry failed webhooks with exponential backoff
  • Delivery Logs: View webhook history and debug issues in your dashboard