Ra mắt môi trường Sandbox

Ra mắt môi trường Sandbox

Kính gửi Quý khách hàng,

Chúng tôi vui mừng thông báo hệ thống đã có môi trường Sandbox — bản sao của toàn bộ nhóm API tra cứu, dùng để tích hợp và chạy kiểm thử tự động mà không tốn credit.

Mỗi request tới Sandbox không trừ credit, không được ghi vào lịch sử tra cứu và không gọi tới ngân hàng. Quý khách có thể gọi thoải mái trong lúc phát triển, kể cả khi tài khoản đã hết credit.

1. Cách sử dụng

Chỉ cần thêm tiền tố /sandbox vào đường dẫn. Header, body và cấu trúc response giữ nguyên như bản thật:

curl --location 'https://api.banklookup.net/sandbox' \
--header 'x-api-key: <api_key>' \
--header 'x-api-secret: <api_secret>' \
--header 'Content-Type: application/json' \
--data '{
    "bank": "MB",
    "account": "1111111111"
}'

Sandbox vẫn yêu cầu đúng cặp API key và secret thật của Quý khách, nhờ vậy phần xác thực cũng được kiểm thử luôn.

2. Kịch bản theo số tài khoản

Đây là phần hữu ích nhất: kết quả do chính số tài khoản quyết định, nên Quý khách chủ động dựng được mọi tình huống lỗi — những nhánh gần như không thể tạo ra có chủ đích trên môi trường thật.

Bốn chữ số đầu chính là mã HTTP sẽ nhận về, nên Quý khách không cần nhớ máy móc. Danh sách đầy đủ nằm trong tài liệu Sandbox.

Số tài khoản bất kỳ ngoài danh sách trên luôn trả về cùng một tên chủ tài khoản, không đổi giữa các lần gọi — thuận tiện cho việc viết assert trong test tự động.

3. Thử ngay trên trình duyệt

Không cần viết code, Quý khách mở khu vực thử nghiệm và chọn môi trường Sandbox là gửi được request ngay.

Với SDK JavaScript, chỉ cần bật một tuỳ chọn:

const client = new BankLookup({ apiKey, apiSecret, sandbox: true });

4. Một vài lưu ý

• Dữ liệu Sandbox là dữ liệu mô phỏng. Đừng dùng Sandbox để kiểm tra một số tài khoản có thật.
• Mã ngân hàng vẫn được đối chiếu với danh sách thật, ảnh và nội dung QR vẫn được giải mã thật — sai ở khâu nào Sandbox báo đúng khâu đó.
• Hạn mức 60 request/phút cho mỗi API key, tính riêng nên không ảnh hưởng tới hạn mức của môi trường thật.
• POST /my-credit không có bản Sandbox vì vốn đã không tốn credit, Quý khách cứ gọi thẳng bản thật.

Chúng tôi hy vọng Sandbox sẽ giúp Quý khách tích hợp nhanh và yên tâm hơn, nhất là ở khâu xử lý các trường hợp lỗi.

Cảm ơn sự đồng hành của Quý khách và kính chúc Quý khách luôn phát triển thịnh vượng!

Trân trọng,

Đội ngũ BankLookup