Sandbox là môi trường thử nghiệm của SePay Bank Hub, cách ly hoàn toàn với Production. Bạn test luồng liên kết, hủy liên kết, khôi phục tài khoản ngân hàng và giao dịch giả lập bằng tài khoản test mẫu, không chạm dữ liệu thật và không cần ngân hàng thật. Vì vậy Sandbox phù hợp cho phát triển, kiểm thử tự động và giảng dạy tích hợp Bank Hub.
Base URL Sandbox
Base URL của môi trường Sandbox Bank Hub:
| Môi trường | Base URL |
|---|---|
| Sandbox | https://bankhub-api-sandbox.sepay.vn |
Thông tin xác thực Sandbox
Mọi yêu cầu Bank Hub xác thực bằng cặp client_id và client_secret của môi trường Sandbox:
your_client_id
your_client_secret
Nếu bạn muốn có thông tin client_id và client_secret riêng hãy liên hệ SePay bằng cách click vào liên hệ ngay bên dưới để được hỗ trợ.
Danh sách tài khoản Sandbox
Dưới đây là danh sách tài khoản mẫu cho các ngân hàng được hỗ trợ. Bạn có thể sử dụng các tài khoản này để test flow liên kết, hủy liên kết và khôi phục tài khoản ngân hàng.
- Chỉ sử dụng trong môi trường sandbox: Tất cả tài khoản trên chỉ hoạt động trong môi trường test.
- Dữ liệu giả lập: Thông tin CMND/CCCD, số điện thoại, OTP đều là dữ liệu giả lập.
- OTP cố định: Mã OTP được cung cấp sẵn cho mỗi tài khoản và không thay đổi.
- Không giới hạn số lần test: Bạn có thể test liên kết/hủy liên kết/khôi phục không giới hạn số lần.
Hướng dẫn sử dụng
- Chọn ngân hàng: Chọn bất kỳ ngân hàng nào trong danh sách trên.
- Chọn loại tài khoản: Chọn tài khoản cá nhân, doanh nghiệp hoặc hộ kinh doanh tùy theo nhu cầu test.
- Nhập thông tin: Sử dụng các thông tin được cung cấp (số tài khoản, CMND/CCCD, số điện thoại nếu có).
- Nhập OTP: Khi được yêu cầu nhập OTP, sử dụng mã OTP được cung cấp trong bảng.
Bạn có thể click vào icon copy bên cạnh mỗi thông tin để copy nhanh vào clipboard.
Purpose REACTIVATE_BANK_ACCOUNT chỉ áp dụng cho tài khoản đang ngừng kích hoạt. Để tạo tài khoản ở diện khôi phục trên sandbox, dùng một ngân hàng thuộc nhóm inactive-only (ví dụ OCB hoặc KienLongBank trong danh sách trên):
- Liên kết tài khoản (purpose
LINK_BANK_ACCOUNT). - Hủy liên kết tài khoản đó (purpose
UNLINK_BANK_ACCOUNT) - với nhóm này thao tác hủy chỉ vô hiệu hóa, tài khoản chuyển sang trạng thái ngừng kích hoạt. - Tạo Link Token purpose
REACTIVATE_BANK_ACCOUNTvớibank_account_xidcủa tài khoản đó để bật lại; theo dõi webhookBANK_ACCOUNT_REACTIVATED.
Bước tiếp theo
Sau khi có thông tin tài khoản sandbox, bạn có thể:
- Bắt đầu nhanh - Thực hiện tích hợp Bank Hub với tài khoản test
- Tạo Link Token - Tạo link token để bắt đầu luồng liên kết
- SDK JavaScript - Tích hợp SDK để mở Hosted Link
Sử dụng tài khoản sandbox ở trên để test luồng liên kết tài khoản ngân hàng trước khi chuyển sang môi trường Production.