Sandbox is the SePay Bank Hub test environment, fully isolated from Production. You test the bank linking, unlinking, and reactivation flow and simulated transactions using sample test accounts, without touching real data or needing a real bank account. That makes Sandbox a good fit for development, automated testing, and teaching Bank Hub integration.
Sandbox base URL
The base URL for the Bank Hub Sandbox environment:
| Environment | Base URL |
|---|---|
| Sandbox | https://bankhub-api-sandbox.sepay.vn |
Sandbox credentials
Every Bank Hub request authenticates with the Sandbox client_id and client_secret pair:
your_client_id
your_client_secret
If you want to have your own client_id and client_secret, please contact SePay by clicking the contact button below for support.
Sandbox Account List
Below is a list of sample accounts for supported banks. You can use these accounts to test the bank account linking, unlinking, and reactivation flow.
- Use only in sandbox environment: All accounts above only work in the test environment.
- Simulated data: ID card/Citizen ID information, phone numbers, OTPs are all simulated data.
- Fixed OTP: OTP codes are provided for each account and do not change.
- Unlimited testing: You can test linking/unlinking/reactivation without limits.
Usage Instructions
- Select a bank: Choose any bank from the list above.
- Select account type: Choose personal, business, or household account based on your testing needs.
- Enter information: Use the provided information (account number, ID card/Citizen ID, phone number if available).
- Enter OTP: When prompted to enter OTP, use the OTP code provided in the table.
You can click the copy icon next to each piece of information to quickly copy it to the clipboard.
Purpose REACTIVATE_BANK_ACCOUNT only applies to a currently deactivated account. To put an account into the reactivation-eligible state on sandbox, use an inactive-only bank (for example OCB or KienLongBank in the list above):
- Link the account (purpose
LINK_BANK_ACCOUNT). - Unlink that account (purpose
UNLINK_BANK_ACCOUNT) - for this group the unlink action only deactivates it, moving the account to the deactivated state. - Create a Link Token with purpose
REACTIVATE_BANK_ACCOUNTand that account'sbank_account_xidto turn it back on; watch for theBANK_ACCOUNT_REACTIVATEDwebhook.
Next Steps
After obtaining sandbox account information, you can:
- Quick Start - Integrate Bank Hub using the test accounts
- Create Link Token - Create a link token to start the linking flow
- JavaScript SDK - Integrate the SDK to open Hosted Link
Use the sandbox accounts above to test the bank account linking flow before switching to Production environment.