Get Started with Direct
A step-by-step guide to help you get started with Direct.
Let's get started by running Direct in the sandbox environment. To start, you will need to sign up for an account on the Brankas Dashboard and generate an API key. We will be guiding you through in this article from how to get started in the sandbox environment followed by the transition to go live.
Set Up Your Sandbox
There are 2 environments available. In the Sandbox environment, you can transact and call data with dummy banks, amounts, currencies and prototype your integrations. There are no limits in the sandbox environment and when you are ready, transition to the live mode where you will be transacting and calling data from customers.
Brankas provides 2 modes:
Environment | Description |
---|---|
Sandbox | A testing ground that allows you to test Brankas APIs with test banks, transactions, and currency. Sandbox endpoints contain .sandbox.bnk.to in the base URL. |
Live | After you have tested in sandbox mode and are ready to go live, submit your go-live requirements on the Brankas Dashboard, and our team will be reaching out to you shortly. |
Account Setup Guide
To start integrating with Brankas products, sign up for an account. A verification email will be sent to your inbox.
For security reasons, Brankas requires you to update your password every 120 days. Request will be sent to your email address.


- Fill in your details to sign up
- Verify your email address
Set up your business details
Add your company information for verification purposes.
Callback URL is optional for Brankas Sandbox environment.
- Go to Settings > Company
- Add company details
- Company name
- Company logo (optional for Sandbox)
- Phone number
- Tax Identification Number (optional for Sandbox)
- Address
- Save changes
Add source or destination bank account
To start transacting in a Sandbox environment, add a dummy bank account for Disburse and Direct.


- Go to Settings > Direct > Add Bank Account
- Fill in dummy bank account detail
- Bank: Brankas Bank
- Account Type: Corporate
- Holder Name: Your Name
- Holder Email: Your Email
- Account Number: Up to 17 digits e.g. 123456789


- Add Account
Generate API Key
An API key is used as an identifier when an API is called or is accessing a website. API keys are required to access sandbox and live environment.


- Go to API Keys > Create Sandbox API Key
- Create a name for your API Key
- Grant permission to each product, in this case Direct = Read/Write
- Continue
Copy and Save API Key
Copy generated API key. Brankas does not save or keep generated API keys.
Postman Setup Guide
1. Import Brankas API Collection in Postman
To start integrating with Brankas products, sign up for an account. A verification email will be sent to your inbox.


-
Click on the import button on the top left corner of the page
-
Import Brankas Sandbox Collection 2.0 by pasting this URL to the input field:
https://www.getpostman.com/collections/bafd08a7069dda4e4b80 -
Brankas Postman Collection | Postman Collection v2.0 | Collection will be added to your Collections
If you lose your API Key, generate a new key and update.
- Copy API key by clicking the copy icon copy
- Click Back to API Key
Setting up your authorization
Next, set up your authorization
For best practices, we recommend to add your API key as Variable and use Postman Environment.


- Select Direct on the Collection Panel
- Update Authorization Type to API key
- Enter x-api-key in the Key field
- Paste your API key that you have generated from Brankas Dashboard in the Value field
4. Your first Sandbox transaction
Now you are ready for your first transaction. For demonstration purposes, let’s start with Direct – Direct allows you to move funds from one bank to another without an intermediary.


- Select [POST] Initiate checkout ID/TH/PH. If your country code is not listed, select any country for the purpose of this demonstration.
- In the Authorization tab, set Authorization type to Inherit Auth from Parent. This simply means that you will use the authentication method from the previous step.
- In the Body tab, replace destination account id: “{{destination_account_id}}” with your Brankas Bank ID (Only replace the orange text) that can be found in Brankas Dashboard > Settings > Direct
- Click Send
- You have initiated your first transaction in Brankas Sandbox. The redirect_url will direct you to Brankas Tap, our frontend interface that allows end-users to complete the transaction. Customization of Tap is available to suit your branding needs.
Experience Brankas Tap UX flow by entering the redirect_url in your browser. You can use these user login credentials:
User Credentials | Details |
---|---|
Username | |
Password | user+7 |
Two Factor Authentication Code | user+7 |
5. Enable Adjustment Fees
Add either ADD
or SUBTRACT
in unique_amount
in the API call as shown.
{
"customer": {
"fname": "John",
"lname": "Johnson",
"mname": "Joseph",
"customer_id": "4f30b317-f98b-4454-bc05-7c4a2e48ec0d",
"email": "[email protected]",
"mobile": "+62-283-5559-907"
},
"reference_id": "9005376336",
"amount": {
"cur": "IDR",
"num": "10000"
},
"from": {
"type": "BANK",
"bank_code": "BCA_PERSONAL",
"country": "ID"
},
"payment_channel": "_",
"memo": "A note attached to the transaction",
"destination_account_id": "b3f1a14c-c0dd-11ea-8f93-ca56f9871a24",
"client": {
"display_name": "Your Application Name",
"logo_url": "https://example.com/logo.svg",
"return_url": "https://example.com/success",
"fail_url": "https://example.com/error"
},
"expiry_date_time": "2021-07-30T00:00:00Z",
"unique_amount": "ADD"
}
6. Enable Transactional Retries
If you have integrated via API, update RetrieveTransaction GET /v1/transaction
instead of RetrieveTransfer GET /v1/transfer
.
If you have integrated via SDK to, update:
- Android - at least v2.6.1
- iOS - at least v2.6.0
Reach out to our support team to update the Client’s BusinessInfo record to `support_retries = true.
Go Live
Prerequisites
- Verified account on the Brankas Dashboard
Once you have tested in the sandbox environment and ready to go live, follow through with these steps:
- Click Go Live Requirements in the banner on your Brankas Dashboard.


- You will be walked through to submit required documents and details based on your business entity and country of operation. Select the tiles applicable to you:


- A summary of required document and details will be listed for you before proceeding. View detailed requirements here.


- Our team will review your submission and reach out to shortly!


Updated 19 days ago