1. 对接信息

名称 数值 说明
商户平台登录地址 —— 用于登录查看商户号相关信息的地址,三维度运营人员提供(随对接文档邮件发放)
商户编号 —— 三维度分配的具有唯一标识性的接入账号,用于技术对接和登录商户平台使用
初始密码 —— 三维度分配的登录商户平台的初始密码,商户可自行修改(联系三维度运营获取)
充值终端号 —— 与商户编号一一对应的业务终端号(随对接文档邮件发放)
版本号 —— 标识支付系统业务的具体版本号(随对接文档邮件发放)
服务器公钥 —— RSA非对称加密中提供服务器方公钥信息(随对接文档邮件发放)

1.1 接口规范

1.1.1 协议规则

传输方式 为保证交易安全性,建议采用HTTPS传输
提交方式 采用POST方法提交
字符编码 统一采用UTF-8字符编码
签名算法 RSA或MD5,根据具体API文档要求配对签名算法
签名要求 请求和接收数据均需要校验签名,详细方法请参考具体API文档要求的签名算法
判断逻辑 先判断协议字段返回,再判断业务返回,最后判断交易状态

1.1.2 请求格式

所有请求格式为json,请求方式为post请求,返回格式json。

1.1.3 MD5加密

请求时的待签名参数按照ASCII码从小到大拼接后,把平台分配的MD5密钥拼接到最后,然后进行MD5签名运算,从而得到签名结果字符串sign。然后把必传参数传过来即可。

1.1.4 RSA加密

1、需要私钥和公钥一起参与签名。私钥与公钥包含在客户获得的数字证书中,称为商户公钥和商户私钥。商户需要和我司平台交换公钥,商户按照API接入文档操作,将生成的公钥上传至我司商户平台,同时获取到我司平台提供的服务器公钥。因此,在签名时,商户要用到的是商户的私钥及我司平台分配的服务器公钥。

2、当拿到请求时的待签名参数后,把待签名参数先通过服务器公钥加密,再将待签名参数与商户的私钥一同放入RSA签名函数中进行签名运算,从而得到签名结果字符串sign。然后把必传参数传过来即可。

1.1.5 注意事项:

1、参数区分大小写。

2、充值业务中所有涉及到金额的单位都是分、1分是最小单位,不能带小数点。

3、对接文档中Y为必传,N为非必传。

4、异步回调处理如果没有返回SUCCESS,我司会每隔三分钟向异步发送一次通知,10次以后将不再发送通知。

5、由于异步通知有重发机制,所以请务必要控制好订单防重,一笔订单只能成功入账一次,避免多次回调多次入账的情况,以免造成商户平台不必要的损失。

1.2 拼装API请求

参数说明:

以下系统参数为支付代扣业务所有接口服务的公共请求参数 ( 在encParam中有具体的业务参数说明,具体业务参数字段参考API文档说明 )

名称 类型 是否必填 描述
merId String Y 商户在支付平台系统经过注册认证后被分配的唯一商户号
version String Y 版本号,缺省 1.0.9
sign String Y 对请求的业务参数内容的数字签名
encParam String Y 对请求的业务参数内容的加密数据(具体的业务参数根据不同的接口所需有所不同)

<form id="paysubmit" name="paysubmit" action="https://www.xxxx/gateway/orderPay"method="post">
<input type="hidden" name="sign"
value="cLFzpk/K1nBJSCowNKWYY9mFdtMhwLUbi+opOgm2SrceqzxPtqct3BfqsxAFmCPVOQAeE7UbXgQPvapjoZwKMf1FzUcF3F9xRLySiWtQO54ZVvXU9jhYnJrgk4Juf12dXx+sctZkZkCae9wGrLbJovARf7+N71SzNCsnYL1kvtg="/>
<input type="hidden" name="merId" value="201709292914064"/>
<input type="hidden" name="encParam"
value="OkXIlem9laas0hddcvHK2oyxCj8eqDOVh3FXVmGIKrcgiiYdIpDV6HeHhRUd9ozIWbx/UfrAuv5SREwJvmBHHQJPzUMe1tShh16O1KU8DTtpuQpXXmfrqAl2Xl3weK/SS6RCTJlhku3vRz4Z4s1/+pHiE9gSw4Jgxh7iPeZgI2NUglThEiICx6NhlKdNvrw/2hTRotapuC/Lqnw545FipfZVjf1zMI36nZsswf6D0Q3P1J0roRpTsbqST97UKldFb1JLLYvIB/yft3lJH2hAq/eB2zJfT3lR13l2J56SI/k1UE7PdnKcSumRVDZ9cAj319sCOlSrStaEm0wZKKraDwQ3SM0XTmu0hSAIqFj/MQTri7ccBaAUGaPwQMyLFABqbO4eLCf1KVtbO4cj41BTgCZHHQKxMRz0DmBEAADvufMsPKaG6saMk4qR2BnpCHhNSiZI0HHintYV76xYrW+zfh+Qm3r4+v5/0ZUofFdL+biwWD0VJY4bL6p+wERbjoPepJ5zqheuCIbvWNki2oczvnHQMhlSZ9spFNFUZCh8v1QG2CtwM+MhwYOik5NJ+HfhTBPKeVE8yaYAHnulfDGkwkKPUSf8vXdd9EVbJ02tEvutU7DlbCwYRT8+lXQSQn3cyFsOINJmWFFrSrvAaPxHHtN8y46b/uMz90DgqZd+Zo="/>
<input type="hidden" name="version" value="1.0.9"/>
<input type="submit" value="gatewayPay" style="display:none;"/>
<"/form>
<script>document.forms['paysubmit'].submit();</script>

1.3 错误码

1.3.1 代扣业务

错误码 错误中文描述 解决方案
1000 成功
0002 商户号格式错误、版本号格式错误 检查提交参数商户号merId和版本号version格式是否正确
0010 商户无权限访问此接口 按照具体API文档提交参数请求方式
0001 商户不存在、请先上传商户公钥 按照文档上传商户公钥到商户平台
0002 商户正在审核中、商户已禁用 提供商户号,联系客服核实具体状态
0003 必传参数为空、同步地址格式错误、异步地址格式错误 检查API文档中必传参数,同步地址syncURL和异步地址asynURL格式是否正确
0004 产生订单失败
0005 订单已处理过,请勿重复提交 检查是否为重复的订单号,不需要二次处理
0006 单笔超额 检查提交的金额是否大于平台约束的单笔最大额
0007 单日超额 检查当日交易的金额是否超额
0035 该商户交易过于频繁,系统拒绝交易 目前交易过于频繁,可稍后再试
0000 版本号不符、验签失败、解密失败 检查版本号version,服务器公钥,商户公/私钥是否正确
0016 未开通支付权限 提供商户号,联系平台客服核实
0020 交易金额格式错误 交易金额以“分”为单位,不能包含小数点,而且必须为纯数字
0021 交易金额无效,交易金额必须大于或等于1元,终端号不存在 检查交易金额数字是否有效,检查终端号terId是否有效

1.3.2 代付业务

错误码 错误中文描述 解决方案
0000 操作成功
0001 操作失败(同时返回信息message中有具体的失败原因说明)
1000 报文解析出错

1.4 接口清单

一级目录 接口 支付业务
支付API 订单支付API
订单状态查询API
获取二维码API
同步/异步通知API
下发API 查询账户余额API
订单状态查询API
单笔转账API
批量转账AP

1.5 核心业务流程

1.5.1 网银支付

1.5.2 扫码支付