Webhooks

Payment Success Event

Receive webhook notifications when a payment completes successfully.

POST {your-webhook-url}

Headers

Header	Description
`x-hitchpay-signature`	HMAC SHA256 signature — verify before processing

Payload Example

{
  "event": "payment.success",
  "data": {
    "reference": "HCHK380B3716D4",
    "status": "successful",
    "amount": "100.00",
    "currency": "NGN",
    "amount_paid": "100.50",
    "paid_at": "2025-11-06T01:59:23.000Z",
    "payment_channel": "dynamic_account",
    "customer": {
      "name": "Jane Doe",
      "email": "[email protected]"
    }
  },
  "sent_at": "2025-11-06T02:00:00.000Z"
}

Expected Response

Your endpoint must return HTTP 200 OK to acknowledge receipt.

{ "status": "ok" }

See Webhook Overview for signature verification and retry schedule.

Questions? Email [email protected]. Also on GitBook.