API reference

Every reference page is generated from the contract Hensa’s servers validate requests against – the docs and the API can’t disagree.

Base URL

https://api.hensa.example/v1

The official domain will be announced at launch; paths and shapes stay the same.

Requests

Authentication	Authorization: Bearer hk_test_… or hk_live_… – see Authentication
Format	JSON (Content-Type: application/json), UTF-8
Creating / touching money	Idempotency-Key header required – see Idempotency
Version	Hensa-Version: 2026-11-01 header (optional) – see Versioning
Money	Integer VND: 150000 = ₫150,000
Time	ISO 8601 with offset
IDs	Prefixed strings: prq_, btx_, whe_, whd_, evt_
Lists	Cursor pagination: limit + cursor → nextCursor – see Pagination
Errors	{ "error": { "code", "message", "request_id" } } – see Errors

Resources

Payment requestsCreate, retrieve and list dynamic VietQR codes.

Bank transactionsIncoming transfers and manual reconciliation.

Webhook endpointsRegister URLs, rotate secrets, inspect and redeliver events.

Test modeSimulate incoming money with test keys.

Webhook events and payloads: Webhooks.

OpenAPI specification

Download the OpenAPI 3.1 spec to import into Postman, Insomnia, Bruno, or to generate a client in your language:

• openapi.en.json – English descriptions
• openapi.vi.json – Vietnamese descriptions