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 →

Test mode

Mọi request bằng khóa hk_test_… chạy trong test mode: dữ liệu tách biệt hoàn toàn khỏi production, webhook vẫn được ký và gửi thật tới endpoint test của bạn.

Không cần đăng ký sandbox riêng, không cần chờ kích hoạt – có tài khoản Hensa là có test mode.

Mô phỏng tiền về

Ngân hàng không chuyển tiền giả được, nên Hensa cho bạn tự “chuyển”:

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" }'

Hensa tạo một giao dịch giả và chạy đúng luồng production: khớp đơn, phát sự kiện, ký, gửi, thử lại.

Kịch bản nên thử

Muốn thử	Gửi `description`	Kết quả mong đợi
Khách chuyển đúng	Chứa `referenceCode`, đúng số tiền	`bank_transaction.created` (`matched`) → `payment_request.paid`
Khách ghi sai nội dung	Không chứa mã tham chiếu	`bank_transaction.created` với `reconciliation: "pending"` – thử khớp thủ công
Khách chuyển thiếu	Đúng mã, số tiền nhỏ hơn	`payment_request.partially_paid`
Mã hết hạn	Không chuyển, chờ 15 phút	`payment_request.expired`
Webhook của bạn lỗi	Cho endpoint trả `500`	Hensa thử lại theo lịch; xem lịch sử gửi trong Dashboard

Bạn cũng có thể bấm “Mô phỏng tiền về” ngay trên Dashboard (dải cam “Chế độ thử nghiệm”).