Go Live Checklist

A detailed checklist to help you transition from sandbox to go live.

We have compiled a detailed checklist to accompany you as you transition to go live.

1. Who is this checklist for

This document is for you if you want to:

  1. Go Live using Brankas products
  2. Test our API on production environment
  3. You have tested in Brankas Sandbox and ready to move on to the next step

📘

Ensure you are familiar with our sandbox before going through this checklist. If you are new to Brankas, we recommend you going through our Quickstart document.

711711

2. How to apply for go-live production

To use our APIs live on production, you need to onboard through our go-live KYC in the Brankas dashboard.

711711
  1. You can access our KYC through the Brankas dashboard by pressing the “Get Live Access” button. You can choose the most appropriate flow for you and follow our simple KYC submission process.
  2. You will be granted live access in a maximum of 2 working days after you have submitted all the required documents. If you have any questions, don’t hesitate to reach out to [email protected].

3. Update source or destination bank account

After getting live access, to begin testing in a production environment with real transactions, add real accounts of financial institutions to work as source/destination accounts. You can find this in the settings tab in the dashboard.

710710
  1. For Disburse: Don’t forget to add the relevant source account with the appropriate API keys. If you don’t have them yet, Brankas can help you onboard with the required financial institution (not yet available for all financial institutions).
  2. For Direct: Add destination account

4. Update Callback URL

Brankas Direct returns callbacks to your pre-registered webhook URL.

In order for you to receive Final and Transitional statuses, you will need to set-up your callback URL for your listener to push the status to required platforms. These statuses are asynchronous to the actual funds transfer process and to ensure that the pushed status won’t be blocked it is best practice to whitelist Brankas call back URL IP: 35.240.194.107 only for callback notification from this IP should be interpreted.

POST 'https://example.com/callback' \
-H 'Content-Type: application/json' \
--data-raw '{
    "transaction_id": "f6355a01-e32b-426e-b2af-85366d305743",
    "status": 2
    "reference_id": “9005376336”
}'

The callback to your webhook URL will include both the relevant fund transfer request’s internal transaction_id along with the status of the operation. This can be then used to query the Brankas Direct Transaction Database directly using the RetrieveTransaction endpoint to retrieve all relevant transaction details.

Field

Type

Description

transaction_id

String

The unique ID assigned to the fund transfer request

reference_id

String

Any additional identifier, such as a UUID, that corresponds to an invoice, cart, or transaction object.

Client can use this field to associate the fund transfer request to a corresponding transaction object in its transaction database.

712712

5. Generate LIVE API Key

Once your Brankas account has been granted live access, you can access the live environment by pressing the top left button on the dashboard.

711711
  1. Go to API Keys > Create LIVE API Key
  2. Create a name for your API Key
  3. Select permission
  4. Continue

Permission settings:

Permission

Description

Excluded

Excludes access to the selected product

Read Only

Enable access to GET API method of the selected product

Read/Write

Enable access to GET and POST API method of the selected product

6. Update all URLs from Sandbox to Production

To begin transacting in production environment and use live data, make sure to change all URLs

Product

Sandbox

Production

Direct

direct.sandbox.bnk.to

direct.bnk.to

Disburse

disburse.sandbox.bnk.to

disburse.bnk.to

Statement

statement.sandbox.bnk.to

statement.bnk.to

Pay

api.pay.sandbox.bnk.to

api.pay.bnk.to

Income

statement.sandbox.bnk.to

statement.bnk.to

Balance

balance.sandbox.bnk.to

balance.bnk.to

7. Tap Customization

Optionally you can also update your Tap (the UI that customers interact with) customization in the production environment.

📘

Note that Tap customization does not carry over from sandbox to production so you must update this for the custom interface to be reflected in live.

711711

8. Testing on production environment

After adding bank accounts, generating production API keys and changing the urls from sandbox to production, updating callback URL and optionally customizing Tap, you are ready for testing on production environment.

9. Go Live

Once you’re satisfied with testing on the production environment, you can immediately go live and empower your business using Brankas.


Did this page help you?