Get Started with Identity

A step-by-step guide to help you get started with Identity.

Let's get started by running Identity in the live environment. To start, you will need to sign up for an account on the Brankas Dashboard and generate an API key.

Account Setup Guide

  1. Set up your Brankas Dashboard
    To start integrating with Brankas products, sign up for an account. A verification email will be sent to your inbox.

  1. Set up your business details

  1. Update Callback URL
    Brankas 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”
    }'
    
FieldTypeDescription
transaction_idStringThe unique ID assigned to the fund transfer request
reference_idStringAny 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.
  1. 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. Below is a sample requirement for registering a foreign company in Indonesia.


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

Postman Setup Guide

  1. Generate API Key
  • Go to API Keys > Create Sandbox API Key
  • Create a name for your API Key
  • Grant permission to each product, in this case Statement
  • Select = Read/Write
  • Click Continue

  1. Import the Brankas API Collection in Postman.
    https://www.getpostman.com/collections/9c43a839402380d72195

📘

Our Postman collection is a permanent link and contains all products available on the sandbox.

  1. Set up your authorization

a. Select Identity on the Collection Panel
b. Update Authorization Type to API key
c. Enter x-api-key in the Key field
d. Paste the API key generated on the Brankas Dashboard into the Value field

  1. Your first static link
    1. Select [POST] Create Statement Retrieval request.
    2. In the Authorization tab, set Authorization type to Inherit Auth from Parent. The authentication method from the previous step.
    3. Update and customize Tap in the Body tab with app_redirect_uri , bank_codes, country, external_id and organization_display_name.

d. Click Send
e. statement_id and redirect_uri will be generated. Open redirect_uri in a browser.

Identifier/AccountPasswordTFA Token
[email protected]user+7user+7
[email protected]user+8user+8
[email protected]user+9user+9
  1. View identity shared

    a. Select [POST] Init Collection
    b. Click Send
    c. View the identity details shared in the Body tab

👍

Congratulations, you have reached the end of this article!

Redeem exclusive Brankas merchandise. Quote “Better With Open Finance” and share this page’s URL to a Brankas representative or email [email protected].