SocGen K Sandbox - OpenBankProject/OBP-API GitHub Wiki
Hello!
This is a special page for the Société Générale OBP API K sandbox.
TL;DR
Go here: Société Générale OBP API Sandbox K
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 recomended 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. socgen-k-api.openbankproject.com !
API documentation
- For the latest version (recomended) see 3.0.0
Customer logins
During the OAuth login, the user of your app will be asked for a customer username/password.
Here are some example logins to test your Direct Login or OAuth flow:
Username Password
Login-User Password account-has-transactioins
1000203891 11111111111111111 all have
1000203892 123456 all have
1000203893 123456 all have
1000203894 123456 all have
1000203905 111111111111111111 02010616971
1000203906 111111111111111111 02010616973
1000203907 111111111111111111 02010616976
1000203908 111111111111111111 02010616978
1000203909 111111111111111111 02010616980
1000203910 111111111111111111 02010616981
1000203911 111111111111111111 02010616982
1000203912 111111111111111111 02010616983
1000203913 111111111111111111 02010616984
1000203915 111111111111111111 02010616991
1000203916 111111111111111111 02010616992
1000203917 111111111111111111 02010616993
1000203918 111111111111111111 02010616996
1000203919 111111111111111111 02010616997
1000203920 111111111111111111 02010616998
1000203921 111111111111111111 02010616999
1000203922 111111111111111111 02010617000
1000203923 111111111111111111 02010617001
1000203924 111111111111111111 02010617002
1000203925 111111111111111111 02010617003
1000203905 111111111111111111 02010616971
1000203906 111111111111111111 02010616973
1000203907 111111111111111111 02010616976
1000203908 111111111111111111 02010616978
1000203909 111111111111111111 02010616980
1000203910 111111111111111111 02010616981
1000203911 111111111111111111 02010616982
1000203912 111111111111111111 02010616983
1000203913 111111111111111111 02010616984
1000203915 111111111111111111 02010616991
1000203916 111111111111111111 02010616992
1000203917 111111111111111111 02010616993
1000203918 111111111111111111 02010616996
1000203919 111111111111111111 02010616997
1000203920 111111111111111111 02010616998
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).
FAQ:
-
Q: I'm getting a 401 even if I enter the right consumer key and secret. Is the endpoint: apisandbox... correct ?
A: No, its socgen-k-api.openbankproject.com
-
Q: I'm getting 404's / errors
A: Avoid trailing slashes:
https://socgen-k-api.openbankproject.com/obp/v2.1.0 200 OK
https://socgen-k-api.openbankproject.com/obp/v2.1.0/ 404 Not Found
https://socgen-k-api.openbankproject.com/obp/v3.0.0/banks 200 OK
https://socgen-k-api.openbankproject.com/obp/v3.0.0/banks/ 200 OK {"error":"error"}
https://socgen-k-api.openbankproject.com/obp/v3.0.0/banks/00100 200 OK
https://socgen-k-api.openbankproject.com/obp/v3.0.0/banks/00100/ 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)
Questions / Contact?
-
To contact Open Bank Project use:
Email: [email protected]
Twitter: @OpenBankProject