-
Notifications
You must be signed in to change notification settings - Fork 430
INV OBP API Sandbox
Welcome. This page is about the INV OBP API sandbox.
INV Fintech, the global fintech accelerator, and the Open Bank Project, the leading open API solution for banks, have teamed up to release an Industry Sandbox for the US.
This sandbox offers a shared and controlled development environment to bring fintech ideas to life. Approved fintech solution providers can access data and services from participating banks to build and showcase their innovative solutions. Powered by Open Bank Project technology, the sandbox contains test data which emulates real transactions and offers access to over 160 standard banking APIs for transactions, payment initiation, KYC checks, and much more.
The sandbox is available to startups selected to join INV’s upcoming cohort and to the twelve financial institution partners supporting the program. Each startup will be able to demonstrate its solution in a simulated bank environment without the difficulties associated with integrating with a real bank infrastructure.
Short link to this page: http://bit.ly/obp-inv
Useful links and minimal instructions:
- The OBP API - where you need to register first
https://apisandbox.openbankproject.com/
- The API Explorer - where you can see all available APIs
https://apiexplorersandbox.openbankproject.com
- *Example data * to test your application
Login with the credentials below or more examples below
"user_name":"Robert.Us.01",
"password":"X!39670561"
- Questions: if you have any questions or need support, Join our slack channel via this link: http://bit.ly/obpslack1
Now,
A) Register as a developer using on https://apisandbox.openbankproject.com/
B) Build your App! See the Starter SDKs to help you!
C) Login as an INV 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 three services since 2 and 3 above are Apps that authenticate against the API using OAuth just like any other App.
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.
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..
- 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
In order to build and test your Apps, you will use two different logins:
-
- Your developer login to get your API keys (see Application registration below)
-
- One or more simulated customer logins to access transaction data etc. (See customer logins below)
Please register your application here. You will get a consumer key and consumer secret for the calls requiring OAuth authentication.
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: apisandbox.openbankproject.com !
-
Q: I'm getting a 401 even if I enter the right consumer key and secret. Is the endpoint: rbs... ?
A: No, its apisandbox.openbankproject.com
-
Q: I'm getting 404's / errors
A: Avoid trailing slashes:
https://apisandbox.openbankproject.com/obp/v1.4.0 200 OK
https://apisandbox.openbankproject.com/obp/v1.4.0/ 404 Not Found
https://apisandbox.openbankproject.com/obp/v1.4.0/banks 200 OK
https://apisandbox.openbankproject.com/obp/v1.4.0/banks/ 200 OK {"error":"error"}
https://apisandbox.openbankproject.com/obp/v1.2.1/banks/inv.01.us.inv 200 OK
https://apisandbox.openbankproject.com/obp/v1.2.1/banks/inv.01.us.inv/ 404 Not Found
-
Q: I'm getting 404s when POSTing
A: Check you have the correct JSON body, headers and encoding. If in doubt, see an example here
-
Q: Why am I not seeing any data for the test user?
A: Make sure you are using the correct bank_id/account_id for the user. Use the OBP API Explorer to check
-
Q: It still doesn't work. Why?
A: Double check parameters are spelt correctly (including http vs https etc.)
A: Check your encoding (use UTF8)
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. Also you may like to use this tutorial on OAuth
- See the OBP API Explorer to browse and test the API.
During the OAuth login, the user of your app will be asked for a customer username/password.
Here are some simulated customer logins to test your App / OAuth flow (use the API Explorer to see which banks they relate to):
{
"user_name":"Robert.Us.01",
"password":"X!39670561",
"email":"[email protected]"
},{
"user_name":"Susan.Us.01",
"password":"X!ba645904",
"email":"[email protected]"
},{
"user_name":"Anil.Us.01",
"password":"X!5ffe4dea",
"email":"[email protected]"
},{
"user_name":"Ellie.Us.01",
"password":"X!df12720c",
"email":"[email protected]"
},{
"user_name":"Rosalie.Us.01",
"password":"X!df05a6b9",
"email":"[email protected]"
},{
"user_name":"Chris.Us.01",
"password":"X!f55b78d5",
"email":"[email protected]"
},{
"user_name":"Dennis.Us.01",
"password":"X!8251c34b",
"email":"[email protected]"
},{
"user_name":"Jane.Us.01",
"password":"X!d62206f7",
"email":"[email protected]"
},{
"user_name":"Emma.Us.01",
"password":"X!f40ef1b4",
"email":"[email protected]"
},{
"user_name":"Sebastien.Us.01",
"password":"X!3c3846fe",
"email":"[email protected]"
},{
"user_name":"Wim.Us.01",
"password":"X!8d18b93b",
"email":"[email protected]"
},{
"user_name":"Simon.Us.01",
"password":"X!113c5732",
"email":"[email protected]"
},{
"user_name":"Jean-paul.Us.01",
"password":"X!097b6a9a",
"email":"[email protected]"
},{
"user_name":"Elise.Us.01",
"password":"X!dbdfc939",
"email":"[email protected]"
},{
"user_name":"Eleanor.Us.01",
"password":"X!3abbc8c2",
"email":"[email protected]"
}
"user_name":"Susan.Uk.01",
"password":"X!a1bd94d9",
"email":"[email protected]"
},{
"user_name":"Anil.Uk.01",
"password":"X!5ca8537e",
"email":"[email protected]"
},{
"user_name":"Ellie.Uk.01",
"password":"X!9c761218",
"email":"[email protected]"
},{
"user_name":"Rosalie.Uk.01",
"password":"X!17cd72ac",
"email":"[email protected]"
},{
"user_name":"Chris.Uk.01",
"password":"X!f0ccaafa",
"email":"[email protected]"
},{
"user_name":"Dennis.Uk.01",
"password":"X!dd43a5b7",
"email":"[email protected]"
},{
"user_name":"Jane.Uk.01",
"password":"X!2b34edf3",
"email":"[email protected]"
},{
"user_name":"Emma.Uk.01",
"password":"X!e5e4adf6",
"email":"[email protected]"
},{
"user_name":"Sebastien.Uk.01",
"password":"X!7af4cefa",
"email":"[email protected]"
},{
"user_name":"Wim.Uk.01",
"password":"X!6d580c69",
"email":"[email protected]"
},{
"user_name":"Simon.Uk.01",
"password":"X!40a9ba1e",
"email":"[email protected]"
},{
"user_name":"Jean-paul.Uk.01",
"password":"X!8b46e410",
"email":"[email protected]"
},{
"user_name":"Elise.Uk.01",
"password":"X!e1d1f443",
"email":"[email protected]"
},{
"user_name":"Eleanor.Uk.01",
"password":"X!da77ee0b",
"email":"[email protected]"
}
NOTE
It works with almost all markdown flavours (the below blank line matters).
To get different logins just for you / your team please ask a member of the Open Bank Project team.
You can use this application which also uses OAuth to browse your transaction data (use the above username/passwords).
-
To contact Open Bank Project use:
Email: [email protected]
Twitter: @OpenBankProject
Slack: openbankproject.slack.com/