Skip to content
HitchPay API Docs

Webhooks

KYC Status Update

POST {your-webhook-url}

HitchPay sends this payload when a customer's KYC verification status changes.

Headers

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

Payload — KYC Approved

{
  "event": "crossborder.kyc.approved",
  "data": {
    "customer_uuid": "42feffe9-d625-412e-bfa5-2f3089a11735",
    "customerid": "CUST_001",
    "kyc_status": "approved",
    "reason": null
  },
  "sent_at": "2026-03-13T10:08:00.000Z"
}

Payload — KYC Rejected

{
  "event": "crossborder.kyc.rejected",
  "data": {
    "customer_uuid": "42feffe9-d625-412e-bfa5-2f3089a11735",
    "customerid": "CUST_001",
    "kyc_status": "rejected",
    "reason": "Document image quality too low"
  },
  "sent_at": "2026-03-13T10:08:00.000Z"
}

Expected Response

{ "status": "ok" }

See Webhook Overview for signature verification details.

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