Beta · The spec may still change before general availability. The API domain api.hensa.example is a placeholder. See changes →

Changelog

2026-11-03 · Additions

Payment requests: new payUrl – the hosted Hensa Pay page to redirect customers to instead of rendering the QR yourself. New amountReceived – the amount received so far.
Webhooks: new event payment_request.partially_paid when a customer underpays. Additive – existing integrations are unaffected; add the event to an endpoint to receive it.
New error: merchant_name_required (422) when creating a live payment request before the store has a name. hk_test_ keys are unaffected.

The first version of the Hensa Connect API.

Payment requests: create, retrieve, list (/payment_requests).
Bank transactions: list, retrieve, manual reconciliation (/bank_transactions).
Webhooks: 4 events, Hensa-Signature (HMAC-SHA256), 8 attempts over ~45 hours, redelivery within 30 days, zero-downtime secret rotation.
Test mode: simulate incoming transfers with POST /test/bank_transfers.
Idempotency, cursor pagination, date-based versioning.