- 接入流程
- 签名验签
- 通用错误码
接入流程
如何创建应用?
登录开放银行服务管理中心,在应用管理模块创建自己所需要的应用。应用的密钥可自主赋值或通 过提供的“自动生成密钥对”工具随机生成。生成后请将私钥拷贝到本地并妥善保管,服务器不保存任何私钥数据
如何申请接口权限?
在应用详情中申请需要签约的产品,管理员审核通过后即可拥有相关接口权限。每个产品可能包含 一个或多个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 | 系统繁忙,如为交易类接口,请先确认交易结果后再处理 |