概述

文档说明

前言

供手机支付开发人员与商户平台服务方技术或业务人员参考和查询。测试账号请联系客服人员。

文档说明

接口说明

通过 http post 的方式交互，请求报文为 json 格式，请求报文由版本号、商户 号、交易信息、 sign(签名)组成，交易信息的内容需加签，详情见签名说明。

文档修订

版本号	修改日期	变更者	变更说明
1.1	2018.10.23	Tinywan	增加点点支付开发者文档
1.0	2018.9.29	Tinywan	重写聚合支付开发者文档

通讯说明

对于客户段请求使用http post 形式进行通讯，接口中的字段名称与值大小写敏感。

1. 对 content 属性的所有字段按照 key=value 的格式，并按照 ASCII 字典排 序。进行urlencode编码，生成：值1

2. 将值1加上 &key=qwertyuiasdfghjklzxcvbnmp1234567，拼接成：值2

3. MD5(值1)，生成加签值3 即为 sign 值，需要把sign转换为小写

4. 最后将结果设值到 sign 属性中用 http post 方式上传至服务器

错误码

网关会对开发者的接口非业务调用错误做统一处理

备注

• https://xxx.com/api/gateway 不作为接口调试的Api请求地址，具体地址以实际开发为准。

公共错误码

code（返回码）	msg（返回码描述）	描述
0	请求成功	请求成功
-1	系统繁忙	系统繁忙
20000	服务不可用	服务暂不可用（网关自身的未知错误）
40001	缺少必选参数	请求参数里面必须要有参数
40002	请求方法不存在	method 不存在
40003	签名错误	请检查签名
40004	商户不存在	商户不存在
40005	商户已被停用	商户已被停用
40006	商户资料未认证	商户资料未认证
40007	子商户不存在	子商户不存在
45009	接口调用超过限制	-
46001	手续费账户余额不足	-
46002	提现支付宝账号未设置，请先设置	-
46003	提现支付宝账号不存在	-
46004	提现支付宝账号未启用	-
46001	手续费账户余额不足	-
46001	手续费账户余额不足	-

业务错误码

code（返回码）	msg（返回码描述）	描述
0	请求成功	请求成功

银行编号

银行编码	银行名称
01020000	工商银行
01050000	建设银行
01030000	农业银行
03080000	招商银行
03010000	交通银行
01040000	中国银行
03030000	光大银行
03050000	民生银行
03090000	兴业银行
03020000	中信银行
03060000	广发银行
03100000	浦发银行
03070000	平安银行
03040000	华夏银行
04083320	宁波银行
03200000	东亚银行
04012900	上海银行
01000000	中国邮储银行
04243010	南京银行
65012900	上海农商行
03170000	渤海银行
64296510	成都银行
04031000	北京银行
64296511	徽商银行
04341101	天津银行