Beta · Hensa-Version 2026-11-01

API nhận tiền chuyển khoản cho website, app và quầy bán hàng.

Tạo mã VietQR cho từng đơn. Khi khách chuyển khoản, Hensa khớp giao dịch với đơn và gửi sự kiện có chữ ký tới máy chủ của bạn, thường chỉ vài giây sau khi ngân hàng báo có.

Bắt đầu trong 5 phút Xem API Reference

Một đơn hàng

08:00:00201
Tạo mã thanh toánPOST /v1/payment_requestsprq_01JD7Q8M · 150.000 ₫ · LK7F3K9
08:03:10MB
Khách chuyển khoảnNgân hàng báo có+150.000 ₫ · "LK7F3K9 thanh toan don hang"
08:03:11matched
Hensa tự khớpTự khớpbtx_01JD7QA9 → prq_01JD7Q8M
08:03:12200
Máy chủ của bạn nhậnPOST cuahang.vn/webhooks/hensapayment_request.paid · 142 ms

Một đơn hàng, từ lúc tạo mã tới khi máy chủ của bạn nhận webhook.

Nơi bạn bán

Một lần tích hợp cho mọi nơi bạn bán

Cùng một API phục vụ trang thanh toán của website, app đặt món, máy tính tiền ở quầy và phần mềm kế toán. Tiền vào thẳng tài khoản ngân hàng của cửa hàng; Hensa không giữ tiền.

Đang phát triển: plugin WooCommerce, Haravan, Sapo · SDK Node.js và PHP · CLI chuyển webhook về máy cá nhân.

Bắt đầu

Từ khóa test tới webhook đầu tiên

Test mode chạy đúng luồng production với tiền giả. Không cần đăng ký sandbox, không cần chờ duyệt.

Tạo khóa testDashboard › Developer › Tạo khóa. Khóa dạng hk_test_ dùng được ngay.
Tạo yêu cầu thanh toánNhận mã QR, mã tham chiếu và thời hạn 15 phút.
Mô phỏng khách chuyển khoảnMáy chủ của bạn nhận payment_request.paid thật, đã ký.

Hướng dẫn đầy đủ

curl https://api.hensa.example/v1/payment_requests \
  -H "Authorization: Bearer $HENSA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 150000, "externalOrderRef": "DH-1024" }'

curl https://api.hensa.example/v1/test/bank_transfers \
  -H "Authorization: Bearer $HENSA_TEST_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 150000, "description": "LK7F3K9 thanh toan don hang", "counterpartyName": "NGUYEN VAN AN" }'

Đặc tả

Thông số kỹ thuật

Những cam kết này là một phần của đặc tả API, không phải lời hứa tiếp thị.

Chữ ký webhook: HMAC-SHA256 trong header Hensa-Signature, từ chối nếu lệch quá 5 phút.
Thử lại: 8 lần trong khoảng 45 giờ, theo lịch công khai. Email cảnh báo sau 3 lần lỗi liên tiếp.
Tạm dừng endpoint: Chỉ sau 7 ngày lỗi liên tục, có email báo trước.
Gửi lại sự kiện: Trong 30 ngày, qua Dashboard hoặc API.
Chống tạo trùng: Header Idempotency-Key, ghi nhớ 24 giờ.
Phiên bản: Theo ngày (hiện tại 2026-11-01). Phiên bản cũ được hỗ trợ ít nhất 12 tháng.
Tài liệu: Tiếng Việt và tiếng Anh. API Reference sinh từ cùng contract mà máy chủ dùng để kiểm tra request.

API Reference

Bắt đầu với khóa test. Miễn phí, không cần liên hệ.

Bắt đầu trong 5 phút