-
Notifications
You must be signed in to change notification settings - Fork 430
openlab HSBC OBP API Sandbox
This is a special page for the openlab HSBC OBP API sandbox.
Go here: openlab HSBC
This document may be updated.
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.
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..
This OBP instance contains simulated customer related data. You can create sandbox payments, customer, products and accounts.
- Get 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.)
- Define Webhooks
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.
The recommended way to authenticate during the hackathon context is to use Direct Login.
To use OAuth1 we recommend you use (and fork) one of our OAuth Starter SDKs
Both Direct Login and OAuth1 will allow you to access the dummy sandbox customer accounts we have created for you.
You can also authenticate using your Google account and the Google OAuth 2 server (link to follow). Note that if you authenticate with your Google account, you will need to create your own accounts and transactions by making payments between accounts.
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. openlab.openbankproject.com !
- For the latest version (recommended) see 3.1.0
The following are power user accounts on the sandbox which have the following entitlements
{
"user_name": "super.user.1",
"password": "X!16a99a4e",
"email": "[email protected]"
},
{
"user_name": "super.user.2",
"password": "X!8bd5ad03",
"email": "[email protected]"
},
{
"user_name": "super.user.3",
"password": "X!fd32256a",
"email": "[email protected]"
},
{
"user_name": "super.user.4",
"password": "X!fd9f36a7",
"email": "[email protected]"
},
{
"user_name": "super.user.5",
"password": "X!b0362f35",
"email": "[email protected]"
},
{
"user_name": "super.user.6",
"password": "X!2aa5f9a2",
"email": "[email protected]"
},
{
"user_name": "super.user.7",
"password": "X!038fbe24",
"email": "[email protected]"
},
{
"user_name": "super.user.8",
"password": "X!bbe98532",
"email": "[email protected]"
},
{
"user_name": "super.user.9",
"password": "X!5d064260",
"email": "[email protected]"
},
{
"user_name": "super.user.10",
"password": "X!80258f24",
"email": "[email protected]"
}
Developers can use the following logins to get access to dummy customer accounts and transactions.
{
"user_name":"Robert.Hk.01",
"password":"X!b3726b93",
"email":"[email protected]"
},
{
"user_name":"Susan.Hk.01",
"password":"X!c46e7262",
"email":"[email protected]"
},
{
"user_name":"Anil.Hk.01",
"password":"X!3b49d64c",
"email":"[email protected]"
},
{
"user_name":"Ellie.Hk.01",
"password":"X!c6cc1cfe",
"email":"[email protected]"
},
{
"user_name":"Rosalie.Hk.01",
"password":"X!0a0b7a91",
"email":"[email protected]"
},
{
"user_name":"Chris.Hk.01",
"password":"X!e5043f01",
"email":"[email protected]"
},
{
"user_name":"Dennis.Hk.01",
"password":"X!77a657d6",
"email":"[email protected]"
},
{
"user_name":"Jane.Hk.01",
"password":"X!7c77a124",
"email":"[email protected]"
},
{
"user_name":"Emma.Hk.01",
"password":"X!13abd253",
"email":"[email protected]"
},
{
"user_name":"Sebastien.Hk.01",
"password":"X!757f0850",
"email":"[email protected]"
},
{
"user_name":"Wim.Hk.01",
"password":"X!49a5ce19",
"email":"[email protected]"
},
{
"user_name":"Simon.Hk.01",
"password":"X!c5cb7549",
"email":"[email protected]"
},
{
"user_name":"Jean-paul.Hk.01",
"password":"X!dd52d6d3",
"email":"[email protected]"
},
{
"user_name":"Elise.Hk.01",
"password":"X!e19960eb",
"email":"[email protected]"
},
{
"user_name":"Eleanor.Hk.01",
"password":"X!eb7fea34",
"email":"[email protected]"
}
{
"user_name":"Robert.Hk.02",
"password":"X!f18356c1",
"email":"[email protected]"
},
{
"user_name":"Susan.Hk.02",
"password":"X!c8b90e6d",
"email":"[email protected]"
},
{
"user_name":"Anil.Hk.02",
"password":"X!f1719d8d",
"email":"[email protected]"
},
{
"user_name":"Ellie.Hk.02",
"password":"X!8b678fa4",
"email":"[email protected]"
},
{
"user_name":"Rosalie.Hk.02",
"password":"X!ad3b892b",
"email":"[email protected]"
},
{
"user_name":"Chris.Hk.02",
"password":"X!19dbee82",
"email":"[email protected]"
},
{
"user_name":"Dennis.Hk.02",
"password":"X!d0f8e48f",
"email":"[email protected]"
},
{
"user_name":"Jane.Hk.02",
"password":"X!19f23462",
"email":"[email protected]"
},
{
"user_name":"Emma.Hk.02",
"password":"X!239fb376",
"email":"[email protected]"
},
{
"user_name":"Sebastien.Hk.02",
"password":"X!d9d2ab4c",
"email":"[email protected]"
},
{
"user_name":"Wim.Hk.02",
"password":"X!6cfee3ce",
"email":"[email protected]"
},
{
"user_name":"Simon.Hk.02",
"password":"X!d889ded0",
"email":"[email protected]"
},
{
"user_name":"Jean-paul.Hk.02",
"password":"X!a086d920",
"email":"[email protected]"
},
{
"user_name":"Elise.Hk.02",
"password":"X!c123ecc1",
"email":"[email protected]"
},
{
"user_name":"Eleanor.Hk.02",
"password":"X!9c9893e7",
"email":"[email protected]"
}
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).
-
Q: I'm getting a 401 even if I enter the right consumer key and secret. Is the endpoint: apisandbox... correct ?
A: No, its openlab.openbankproject.com
-
Q: I'm getting 404's / errors
A: Avoid trailing slashes:
https://openlab.openbankproject.com/obp/v3.0.0 200 OK
https://openlab.openbankproject.com/obp/v3.0.0/ 404 Not Found
https://openlab.openbankproject.com/obp/v3.0.0/banks 200 OK
https://openlab.openbankproject.com/obp/v3.0.0/banks/ 400 Not Found {"error":"OBP-30001: Bank not found. Please specify a valid value for BANK_ID."}
https://openlab.openbankproject.com/obp/v3.0.0/banks/bop.01.com.au 200 OK
https://openlab.openbankproject.com/obp/v3.0.0/banks/bop.01.com.au/ 404 Not Found
-
Q: Why doesn't it work?
A: Double check parameters are spelt correctly (including http vs https etc.)
A: Check your encoding (use UTF8)
-
To contact Open Bank Project use:
Email: [email protected]
Twitter: @OpenBankProject