• 接入流程
  • 签名验签
  • 通用错误码

接入流程

如何创建应用?

登录开放银行服务管理中心,在应用管理模块创建自己所需要的应用。应用的密钥可自主赋值或通 过提供的“自动生成密钥对”工具随机生成。生成后请将私钥拷贝到本地并妥善保管,服务器不保存任何私钥数据


如何申请接口权限?

在应用详情中申请需要签约的产品,管理员审核通过后即可拥有相关接口权限。每个产品可能包含 一个或多个API接口,具体参看接口文档


如何使用SDK?

我们提供多种开发语言的Server-Side SDK,你可以根据需要选择使用。参照接口文档中的“SDK接 入示例”三步骤:设置SDK密钥信息、准备请求参数和调用SDK方法

签名验签

Q1:如何解决报错:OPEN25001 “签名验证失败,请检查签名值”?

A1:请核对传参中应用编号(KEYID)、请求签名私钥是否正确。


  • (1)检查密钥配置是否正确;
  • (2)可采取不传参数方式校验密钥配置是否正确,若不传业务参数时请求返回参数错误/xx参数不能为空等提示,则密钥校验通过,此时需要检查请求参数与接口文档是否一致,是否存在多传/错传。若存在list、Map等集合参数,请检查传参方式是否正确;
  • (3)与接口提供方确认API请求报文格式(application/json或application/x-www-form-urlencoded),两种格式需分别对应SDK工具类中OpenSdk.gatewayWithKeyId()与OpenSdk.gatewayJsonWithKeyId()方法;
  • (4)确保最终调用时,签名值以及相关认证信息不为空 ;

通用错误码

CODE说明
OPEN25001验签失败
OPEN25002请求过期
OPEN25003未配置密钥信息
OPEN25004超过调用频率限制
OPEN25101输入参数格式错误
OPEN25201没找到对应的请求资源
OPEN25202没找到对应的商户信息
OPEN25203该请求无权限访问
OPEN25204请求参数未找到
OPEN25205没有找到对应的服务
OPEN25206权限不足
OPEN25207文件不存在或传输异常
OPEN25301调用服务参数不符合要求
OPEN25302后端服务返回未知异常
OPEN25999系统繁忙,如为交易类接口,请先确认交易结果后再处理