跳转到内容
建设中

本站正在持续完善,沙箱环境即将上线。

本站为独立、非官方的个人技术学习项目,不代表任何银行、金融机构或监管机构。

认证与授权

所有 API 请求都必须携带访问令牌。令牌通过 OAuth 2.0 授权码流程获取,公共客户端必须使用 PKCE。

  1. 应用将用户重定向到授权端点,并携带 client_id、redirect_uri、scope 与 state。
  2. 用户在银行页面完成身份验证,并确认授权范围。
  3. 银行将授权码回调到 redirect_uri。
  4. 应用在服务端用授权码换取访问令牌。
应用 ──授权请求──▶ 授权服务器 ──登录/授权──▶ 用户
应用 ◀──授权码──── 授权服务器
应用 ──换取令牌──▶ 令牌端点 ──▶ access_token + refresh_token

访问令牌默认有效期为 1 小时。过期后使用 refresh_token 换取新令牌,无需再次打扰用户。

终端窗口
curl -X POST https://api.openbanking.org.cn/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=refresh_token" \
-d "refresh_token=$REFRESH_TOKEN" \
-d "client_id=$CLIENT_ID"
scope 说明
accounts 读取账户基本信息
balances 读取账户余额
transactions 读取交易明细
payments 发起支付指令

用户可以在银行应用中随时撤销授权。应用侧应监听撤销事件,并删除本地保存的令牌。

终端窗口
curl -X POST https://api.openbanking.org.cn/oauth/revoke \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=$ACCESS_TOKEN" \
-d "client_id=$CLIENT_ID"