Skip to content

NMB Bank Sandbox

Jump to bottom Edit New page
tesobe-daniel edited this page Jul 23, 2021 · 1 revision

Hello!

Welcome! This page is about the NMB Bank OBP API sandbox.

TL;DR

Useful links and minimal instructions:

  1. The OBP API:

https://obp-api-sandbox.nmbbank.co.tz/

  1. The API Explorer:

https://obp-apiexplorer-sandbox.nmbbank.co.tz

Login with these credentials, or see below for more test user accounts:

    username / password : Robert.Nmbb.01 / X!317fa36e
  1. The latest DRAFT and STABLE APIs endpoints are:

https://obp-api-sandbox.nmbbank.co.tz/obp/v4.0.0

https://obp-api-sandbox.nmbbank.co.tz/obp/v3.1.0

Now,

A) Register as a developer using 1 above.

B) Build your App! See the Starter SDKs to help you!

C) Login as an Example Bank Customer (see more logins below) so your App has access to customer data. You may need to first logout on 1 above as you may already be logged in as a developer!

The logins above and below are valid for all services since they are Apps that authenticate against the API using OAuth just like any other App.

Overview

Open Bank Project is an open source API for banks providing a common RESTful interface for developers to build customer facing applications. You can use it as a flexible toolbox of data and services to help realise (a.k.a. hack!) your ideas together. For the hackathons, developers have access to simulated transaction data for imaginary customers.

What sort of applications can I build with the OBP API?

Customer facing retail banking and fintech applications for consumers, SMEs, associations, charities, governments and NGOs; including (but not limited to!) Personal Finance Management (PFM) Solutions, online accounting integration, financial widgets, Savings Apps, Education Apps, Gamification, Peace of Mind Apps, Transparency Apps, Crowd funding, on boarding, CRM etc..

What data and services can I access?

  • Account information, balance and transaction history of multiple bank accounts
  • Enrich bank transactions with metadata (tags, comments, urls and geolocation) for example to link a receipt or video to a transaction
  • Create/Access different views on accounts. Each view grants a subset of the data to a restricted group of users. For example, a customer could offer special views on his account to his accountants, auditors or regulators. A charity might open their accounts to the public
  • Initiate payments
  • Access Customer messages
  • Access data related to branches, ATMs and financial products

API Endpoint:

https://obp-api-sandbox.nmbbank.co.tz/obp/v4.0.0

API Explorer:

Use the OBP API Explorer to browse and test the API.

This OBP instance contains simulated test accounts for test banks:

Important Note to Developers:

In order to build and test your Apps, you will use two different logins:

    1. Your developer login to get your API keys (see Application registration below)
    1. One or more simulated customer logins to access transaction data etc. (See customer logins below)

Application registration

Please register your application here. You will get a consumer key and consumer secret for the calls requiring OAuth or DirectLogin authentication.

OAuth

To get started with OBP and OAuth we recommend you use (and fork) one of our Starter SDKs

Note: Make sure you use the correct domain in all calls i.e. for this sandbox use: https://obp-api-sandbox.nmbbank.co.tz !

FAQ:

Technical details about the OAuth flow including getting a request token, redirecting the user, getting an access token and accessing protected resources are available here. Please ask us (see below) if you are stuck with this.

API documentation

Customer logins

Here are some simulated customer logins to test your App / Authentication flow

(use API Explorer to see which banks each user has accounts at):

` "user_name":"Robert.Nmbb.01", "password":"X!317fa36e", "email":"robert.nmbb.01@x.y"

  "user_name":"Susan.Nmbb.01",
  "password":"X!19fbbe5c",
  "email":"susan.nmbb.01@x.y"

  "user_name":"Anil.Nmbb.01",
  "password":"X!0133bddd",
  "email":"anil.nmbb.01@x.y"

  "user_name":"Ellie.Nmbb.01",
  "password":"X!0a745cc6",
  "email":"ellie.nmbb.01@x.y"

  "user_name":"Rosalie.Nmbb.01",
  "password":"X!313002ef",
  "email":"rosalie.nmbb.01@x.y"

  "user_name":"Chris.Nmbb.01",
  "password":"X!b73475de",
  "email":"chris.nmbb.01@x.y"

  "user_name":"Dennis.Nmbb.01",
  "password":"X!cc69f4a1",
  "email":"dennis.nmbb.01@x.y"

  "user_name":"Jane.Nmbb.01",
  "password":"X!bca085b1",
  "email":"jane.nmbb.01@x.y"

  "user_name":"Emma.Nmbb.01",
  "password":"X!c2fe4c0a",
  "email":"emma.nmbb.01@x.y"

  "user_name":"Sebastien.Nmbb.01",
  "password":"X!5bf3fb2c",
  "email":"sebastien.nmbb.01@x.y"

  "user_name":"Wim.Nmbb.01",
  "password":"X!78b757b4",
  "email":"wim.nmbb.01@x.y"

  "user_name":"Simon.Nmbb.01",
  "password":"X!c187a4bd",
  "email":"simon.nmbb.01@x.y"

  "user_name":"Jeanpaul.Nmbb.01",
  "password":"X!f58ddece",
  "email":"jean-paul.nmbb.01@x.y"

  "user_name":"Elise.Nmbb.01",
  "password":"X!7f525d1b",
  "email":"elise.nmbb.01@x.y"

  "user_name":"Eleanor.Nmbb.01",
  "password":"X!c7d23f46",
  "email":"eleanor.nmbb.01@x.y"

`

To get different logins just for you / your team please ask a member of the Open Bank Project team.

Questions / Contact?

Add a custom footer
Add a custom sidebar
Clone this wiki locally