IN PROGRESS
This site is under active development. The sandbox is coming soon.
This is an independent, unofficial personal learning project. It does not represent any bank, financial institution, or regulator.
Quickstart
This page walks you through a complete integration in about ten minutes: register an application, obtain a token, and read your account list.
1. Prepare your application
Section titled “1. Prepare your application”After creating an application in the developer portal, you receive a set of credentials:
client_id: the application identifier, which may be publicclient_secret: the application secret, stored only on your serverredirect_uri: the callback address after authorization completes
2. Obtain an access token
Section titled “2. Obtain an access token”Exchange the authorization code for a token:
curl -X POST https://api.openbanking.org.cn/oauth/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=authorization_code" \ -d "code=$AUTH_CODE" \ -d "client_id=$CLIENT_ID" \ -d "client_secret=$CLIENT_SECRET" \ -d "redirect_uri=$REDIRECT_URI"Example success response:
{ "access_token": "eyJhbGciOiJSUzI1NiIs...", "token_type": "Bearer", "expires_in": 3600, "refresh_token": "def50200...", "scope": "accounts transactions"}3. Read accounts
Section titled “3. Read accounts”curl https://api.openbanking.org.cn/v1/accounts \ -H "Authorization: Bearer $ACCESS_TOKEN"Next steps
Section titled “Next steps”- Read Authentication & authorization to learn about token refresh and revocation.
- Read Account information to learn about pagination and incremental sync.