Beta · Đặc tả có thể còn thay đổi trước khi ra mắt chính thức. Tên miền API api.hensa.example là tạm thời. Xem thay đổi →

Changelog

2026-11-03 · Bổ sung

Yêu cầu thanh toán: thêm payUrl – trang thanh toán Hensa để chuyển khách sang, thay vì tự hiển thị QR. Thêm amountReceived – số tiền đã nhận.
Webhook: sự kiện mới payment_request.partially_paid khi khách chuyển thiếu. Thay đổi bổ sung – không ảnh hưởng tích hợp hiện có; muốn nhận thì thêm sự kiện vào endpoint.
Lỗi mới: merchant_name_required (422) khi tạo yêu cầu thanh toán ở chế độ thật mà cửa hàng chưa đặt tên. Không ảnh hưởng khóa hk_test_.

Phiên bản đầu tiên của Hensa Connect API.

Yêu cầu thanh toán: tạo, lấy, liệt kê (/payment_requests).
Giao dịch ngân hàng: liệt kê, lấy, khớp thủ công (/bank_transactions).
Webhook: 4 sự kiện, chữ ký Hensa-Signature (HMAC-SHA256), thử lại 8 lần trong ~45 giờ, gửi lại trong 30 ngày, đổi secret không gián đoạn.
Test mode: mô phỏng tiền về POST /test/bank_transfers.
Idempotency, phân trang con trỏ, phiên bản theo ngày.