Skip to content

Beyond Banking OBP API Sandbox

Jump to bottom Edit New page
Mulugeta Ayalew edited this page Jun 8, 2018 · 12 revisions

Hello!

This is a special page for the Beyond Banking OBP API sandbox.

TL;DR

Go here: Beyond Banking

Status

This document may be updated.

Overview

Open Bank Project is an open source API for banks that provides a RESTful interface for developers to build customer facing applications without needing to code for each bank or account type differently. 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 that match certain customer profiles.

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?

This OBP instance contains simulated customer related data.

Simulated Customer related data / APIs include:

  • 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
  • Onboard Customers (KYC etc.)

Application registration

You will need to register your application here. You will get a consumer key and consumer secret for the calls requiring OAuth or Direct Login authentication.

Direct Login and OAuth

The recommended way to authenticate in the hackathon context is to use Direct Login.

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

Note: Many examples in the docs / SDKs use the general OBP sandbox domain. Make sure you use the correct domain in all calls i.e. beyondbanking.openbankproject.com !

Recorded webinar - On Open Bank Project API and Sandbox

  • Watch this recorded webinar to learn about Open Bank Project, OBP API and the beyondbanking sandbox Watch the video

Recorded webinar - Get Started with OBP API

  • Watch the following recorded webinar to see how you can register as a developer on the sandbox, get API keys, authenticate using Direct Login and OAuth 2.0.

Watch the video

API documentation

  • For the latest version (recommended) see 3.0.0

Power Users

The following are power user accounts on the sandbox which have the following entitlements

CanCreateAccount (for banks bb.03.uk.uk, bb.03.nl.nl, bb.03.nlbb.nlbb)
CanCreateCardsForBank (for banks bb.03.uk.uk, bb.03.nl.nl, bb.03.nlbb.nlbb)
    CanCreateAnyTransactionRequest (for banks bb.03.uk.uk, bb.03.nl.nl, bb.03.nlbb.nlbb)
CanCreateConsumer
CanCreateAtmAtAnyBank
CanCreateBank
CanCreateBranchAtAnyBank
CanCreateCustomerAtAnyBank
CanCreateFxRateAtAnyBank
CanCreateProductAtAnyBank
CanCreateUserCustomerLinkAtAnyBank
CanUseFirehoseAtAnyBank
    

   {
    "user_name":"poweruser1",
    "password":"X!79877201a",
    "email":"poweruser1@example.com"
   }, {
    "user_name":"poweruser2",
    "password":"X!79877201b",
    "email":"poweruser2@example.com"
   }, {
    "user_name":"poweruser3",
    "password":"X!79877201c",
    "email":"poweruser3@example.com"
   }

Customer logins

Developers can use the following logins to get access to dummy customer accounts and transactions.

   {
    "user_name":"Robert.Nl.03",
    "password":"X!79877297",
    "email":"robert.nl.03@x.y"
  },{
    "user_name":"Susan.Nl.03",
    "password":"X!83357009",
    "email":"susan.nl.03@x.y"
  },{
    "user_name":"Anil.Nl.03",
    "password":"X!26c96541",
    "email":"anil.nl.03@x.y"
  },{
    "user_name":"Ellie.Nl.03",
    "password":"X!bffbc3aa",
    "email":"ellie.nl.03@x.y"
  },{
    "user_name":"Rosalie.Nl.03",
    "password":"X!69fd0e03",
    "email":"rosalie.nl.03@x.y"
  },{
    "user_name":"Chris.Nl.03",
    "password":"X!f684b161",
    "email":"chris.nl.03@x.y"
  },{
    "user_name":"Dennis.Nl.03",
    "password":"X!96f1f5d5",
    "email":"dennis.nl.03@x.y"
  },{
    "user_name":"Jane.Nl.03",
    "password":"X!eda9685a",
    "email":"jane.nl.03@x.y"
  },{
    "user_name":"Emma.Nl.03",
    "password":"X!94c7e6af",
    "email":"emma.nl.03@x.y"
  },{
    "user_name":"Sebastien.Nl.03",
    "password":"X!f99cd514",
    "email":"sebastien.nl.03@x.y"
  },{
    "user_name":"Wim.Nl.03",
    "password":"X!bee4efdc",
    "email":"wim.nl.03@x.y"
  },{
    "user_name":"Simon.Nl.03",
    "password":"X!21e285b3",
    "email":"simon.nl.03@x.y"
  },{
    "user_name":"Jean-paul.Nl.03",
    "password":"X!d8a4c3c7",
    "email":"jean-paul.nl.03@x.y"
  },{
    "user_name":"Elise.Nl.03",
    "password":"X!4c7317a2",
    "email":"elise.nl.03@x.y"
  },{
    "user_name":"Eleanor.Nl.03",
    "password":"X!8b1baacc",
    "email":"eleanor.nl.03@x.y"
  },{
    "user_name":"Robert.Nlbb.03",
    "password":"X!741f29e5",
    "email":"robert.nlbb.03@x.y"
  },{
    "user_name":"Susan.Nlbb.03",
    "password":"X!3ef9c87d",
    "email":"susan.nlbb.03@x.y"
  },{
    "user_name":"Anil.Nlbb.03",
    "password":"X!61e277ee",
    "email":"anil.nlbb.03@x.y"
  },{
    "user_name":"Ellie.Nlbb.03",
    "password":"X!eb62001c",
    "email":"ellie.nlbb.03@x.y"
  },{
    "user_name":"Rosalie.Nlbb.03",
    "password":"X!8c90224b",
    "email":"rosalie.nlbb.03@x.y"
  },{
    "user_name":"Chris.Nlbb.03",
    "password":"X!c3cf1b67",
    "email":"chris.nlbb.03@x.y"
  },{
    "user_name":"Dennis.Nlbb.03",
    "password":"X!41522bd9",
    "email":"dennis.nlbb.03@x.y"
  },{
    "user_name":"Jane.Nlbb.03",
    "password":"X!d0a9e1af",
    "email":"jane.nlbb.03@x.y"
  },{
    "user_name":"Emma.Nlbb.03",
    "password":"X!e8240c89",
    "email":"emma.nlbb.03@x.y"
  },{
    "user_name":"Sebastien.Nlbb.03",
    "password":"X!0be15a5e",
    "email":"sebastien.nlbb.03@x.y"
  },{
    "user_name":"Wim.Nlbb.03",
    "password":"X!4047fd0f",
    "email":"wim.nlbb.03@x.y"
  },{
    "user_name":"Simon.Nlbb.03",
    "password":"X!c370a4ff",
    "email":"simon.nlbb.03@x.y"
  },{
    "user_name":"Jean-paul.Nlbb.03",
    "password":"X!22347a41",
    "email":"jean-paul.nlbb.03@x.y"
  },{
    "user_name":"Elise.Nlbb.03",
    "password":"X!114e6df7",
    "email":"elise.nlbb.03@x.y"
  },{
    "user_name":"Eleanor.Nlbb.03",
    "password":"X!ba5a6b6b",
    "email":"eleanor.nlbb.03@x.y"
  }

Please ask a member of the Open Bank Project team for more logins if you require. You can use this application which also uses OAuth to browse your transaction data (use the above username/password).

REST client examples (Curl format)

Direct Login beyondbanking Bank Robert

curl -X "POST" "https://beyondbanking.openbankproject.com/my/logins/direct"
-H 'Authorization: DirectLogin username="Robert.Us.44", password="X!252b3849", consumer_key="rguxbfjoynfmydwt3553dtwf0mcxdkeyzrmadd0q"'
-H 'Content-Type: application/json'

Get Accounts beyondbanking Bank

curl "https://beyondbanking.openbankproject.com/obp/v3.0.0/my/accounts"
-H 'Cookie: JSESSIONID=17ndfpl0wl8eu564gy3a2i6yb'
-H 'Authorization: DirectLogin token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyIiOiIifQ.tsQ4uvy9nrNGVUnbSuS_FxSdEObcY-LDYgvGlrgCMxg"'
-H 'Content-Type: application/json'

Create Transation Request beyondbanking Bank

curl -X "POST" "https://beyondbanking.openbankproject.com/obp/v3.0.0/banks/cb.44.us.cb/accounts/b73579ec-a6d0-4c68-9442-f25f65ab4700/owner/transaction-request-types/SANDBOX_TAN/transaction-requests"
-H 'Authorization: DirectLogin token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyIiOiIifQ.tsQ4uvy9nrNGVUnbSuS_FxSdEObcY-LDYgvGlrgCMxg"'
-H 'Content-Type: application/json'
-d $'{ "value": { "currency": "USD", "amount": "21" }, "to": { "bank_id": "cb.44.us.cb", "account_id": "fffa4d8c-29b0-49d0-adde-1c63680865be" }, "description": "Small Beer" }'

Get Transactions beyondbanking Bank

curl "https://beyondbanking.openbankproject.com/obp/v2.1.0/my/banks/cb.44.us.cb/accounts/b73579ec-a6d0-4c68-9442-f25f65ab4700/transactions"
-H 'Cookie: JSESSIONID=17ndfpl0wl8eu564gy3a2i6yb'
-H 'Authorization: DirectLogin token="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyIiOiIifQ.tsQ4uvy9nrNGVUnbSuS_FxSdEObcY-LDYgvGlrgCMxg"'
-H 'Content-Type: application/json'

FAQ:

Questions / Contact?

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