Quick Start Guide

You will be up and running Direct in sandbox at the end of this article.

This quick start guide will help you get up and running with Brankas Direct.

1. Sign up and verify your account

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 to update will be sent via email.

  1. Fill in your details to sign up
  2. Verify your email address

2. Set up your business details

Add your company information for verification purposes.

📘

Callback URL is optional for Brankas Sandbox environment.

  1. Go to Settings > Company
  2. Add company details
    • Company name
    • Company logo (optional for Sandbox)
    • Phone number
    • Tax Identification Number (optional for Sandbox)
    • Address
  3. Save changes

3. Add source or destination bank account

To start transacting in a Sandbox environment, add a dummy bank account for Disburse and Direct.

📘

We will be setting up Brankas Direct in this guide.

  1. Go to Settings > Direct > Add Bank Account
  2. 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
  3. Add Account

4. 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.

  1. Go to API Keys > Create Sandbox API Key
  2. Create a name for your API Key
  3. Grant permission to each product, in this case Direct = Read/Write
  4. Continue

5. Copy and Save API Key

Copy generated API key. Brankas does not save or keep generated API keys.

❗️

If you lose your API Key, generate a new key and update.

  1. Copy API key by clicking the copy icon copycopy
  2. Click Back to API Key

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.

  1. Click on the import button on the top left corner of the page

  2. Import Brankas Sandbox Collection 2.0 by pasting this URL to the input field:
    https://www.getpostman.com/collections/bafd08a7069dda4e4b80

  3. Brankas Postman Collection | Postman Collection v2.0 | Collection will be added to your Collections

2. Setting up your authorization

Next, set up your authorization

📘

For best practices, we recommend adding your API key as Variable and using Postman Environment.

  1. Select Direct on the Collection Panel
  2. Update Authorization Type to API key
  3. Enter x-api-key in the Key field
  4. Paste your API key that you have generated from Brankas Dashboard in the Value field

3. 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.

  1. Select [POST] Initiate checkout ID/TH/PH. If your country code is not listed, select any country for the purpose of this demonstration.
  2. In the Authorization tab, set the Authorization type to Inherit Auth from Parent. This simply means that you will use the authentication method from the previous step.
  3. 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
  4. Click Send
  5. 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

[email protected]

Password

user+7

Two Factor Authentication Code

user+7

What’s Next

Congratulations! You have completed Brankas Quickstart by initiating your first transaction. You can now view the transaction status on the Brankas Dashboard or explore more of our products.

Disburse funds from your accounts to multiple beneficiaries, retrieve complete bank transaction data using Statement, give financial overview to your users through Balance and understand your users with Income.

Reach out to our team for any queries and we will get back to you shortly!


Did this page help you?