聚合支付接口规范

聚合支付接口规范

目录

聚合支付接口规范1

目录2

1引言以及开发规范3

1.1编写目的3

1.2开发规范3

1.3安全要求3

1.4参考资料3

2接口定义4

2.0接口公共参数（请求公共参数报文内容，不含支付回调）4

2.1统一下单gateway.unified.pay4

2.2订单支付结果通知5

2.3查询订单付款状态order.query.status6

2.4交易订单申请退款order.refund.api6

2.6查询入网结果和状态uni.mer.query7

2.7商户便捷入网方式（代理商与普通商户通用）7

2.8微信实名认证（开户意愿确认接口）wechat.pay.init8

2.9同步微信投诉数据wechat.tousu.init8

1引言以及开发规范

1.1编写目的

本文档针对于使用合支付接口文档的客户，方便各位商家快速接入我司聚合支付接口。

系统支持银联、支付宝、微信端开发。

1.2开发规范

1、接口采用HTTP或者HTTPS传输协议，采用UTF-8编码。用POST方式提交数据。

2、字段命名必须字母加下划线方式，所有字段命名全部小写。

3、接口中各字段限制标识是M时参数必选，为。时可选，为C时需要依赖于其它字段

1.3安全要求

1、我公司支持使用MD5签名算法

2、将数据内的非空参数值的参数按照参数名ASCII码从小到大排序（字典序）；

3、假设数据为空，则此字段不加入签名。

4、传送的res_body字段请加入签名前做排序处理（ASCII码从小到大排序（字典序））

5、参数值sign_type需加入签名中。

6、res_body应为String数据，如php方式为json_encode

7、所有参数加入签名口寸为原报文内容（不剔除空格及特殊字符）进行签名

1.4参考资料

MD5签名算法：

1、将发送或接收到的数据内的非空参数值的参数按照参数名ASCII码从小到大排序，（字

典序），使用URL键值对的格式（即key1=value1&key2二value2…）拼接成字符串stringA;

2、假设您的数据为key1=value1&key2=value2,那么拼接参数最后拼接您的秘钥，如

key1=&key2=value2F5S1AD0G54AGGADE

传送的MD5、SHA1加密后SIGN参数为小写请注意；签名内容非大写

1.5网关地址:

2接口定义

2.0接口公共参数（请求公共参数报文内容，不含支付回调）

参数名参数说明必填参数使用及详细说明

open_userid用户编号M由我司分配的唯一用户编号（代理通用）

res_body报文内容MJS0N数据，接口报文内容

service接口名M网关接口英文名

sign_type签名方式M目前仅支持MD5

sign签名内容M参照安全要求与规范

公共返回参数:

参数名参数说明必填参数使用及详细说明

rsp_code请求结果M交易请求结果0000为成功

通常rsp_code不为0000时返回本次订单交易发

rsp_msg返回原因M

起失败的原因

相关接口

request_arrayC请求结果为0000时返回

返回内容

2.1统一下单gateway.unified.pay

请求订单交易参数

参数名参数说明必填参数使用及详细说明

sub_mch_id交易商户号指定子商户号进行交易（代理商时必传）

sub_type轮训类型如需要让系统轮训，而非指定商户号时请传：

二选一"SYSTEM”此处需大写（不含引号空格）

如果您为代理商，请传输sub_mch_id不支持

自动轮训此功能

uhanriel_Lypc交易通道M支付宝（通用版）：ALIPAY

微信公众号：WECHAT.MP

微信卜5支付（小程序）：WECHAT_H5

云闪付：UNIONPAY_QR

交易金额

total_feeM交易金额，单位元

单位为元

系统订单商品名称

pay_name商品名称M

（不上送微信支付，仅用于系统内）

pay_body商品描述M商品的详细说明，字段上送微信支付

notify_urI回调地址M回调异步通知地址

out_trade_no商户单号M在您系统的商户单号，建议不重复。

购买此商品下单用户的IP地址

付款用户此参数不支持IPV6,仅支持IPV4

user_ipM

IP要下单的时候获取客户实际IP提给后台

否则系统会报错

server_urI商家地址M商家的网站地址

request_array响应参数

参数名参数说明必填参数使用及详细说明

rsp_code请求结果M交易请求结果0000为成功

通常rsp_code不为0000时返回本次订单交易发

rsp_msg返回原因M

起失败的原因

request_array其他内容C请求结果为0000时返回附带参数

request_array参数内容

参数名参数说明必填参数使用及详细说明

pay_urI付款地址C支付宝微信或银联扫码进行付款（自产码）

微信支付下单H5返回

wechat_redirect徵信H5C

返回实例：weixin://dl/business/?t=xxx

微信支付下单H5返回，小程序APPID适用于

wechat_appid小程序IDC

微信小程序内下单或APP下单后调用

system_order_id系统流水号M用于查询订单交易结果与订单退款

2.2订单支付结果通知

1、收到支付结果通知后请返回大写SUCCESS，目前我公司仅通知一次成功消息！

2、通知签名方式与订单相同，如发起支付签名方式为RSA2则支付通知也为RSA2

参数名参数说明必填参数使用及详细说明

open_userid商户编号M我司分配的商户编号（代理通用）

out_trade_no商户订单号M商户订单编号

system_order_id系统流水号M用于查询订单交易结果与订单退款

我司系统流水编号、订单编号

三方支付单号（微信支付宝银联云闪付内商户

pay_external_id银行单号M

订单编号即此数据订单号）

total_fee订单金额M订单金额（单位元）

sign/M/

2.3查询订单付款状态order.query.status

请求网关需求参数

参数名参数说明必填参数使用及详细说明

system_order_id系统流水号M通过订单下单接口获取的订单流水号

requestarray返回参数

参数名参数说明必填参数使用及详细说明

status付款状态M订单支付状态

0：待用户付款，1：付款完成

2.4交易订单申请退款order.refund.api

请求网关需求参数

参数名参数说明必填参数使用及详细说明

bank_order银行订单号M/

request_array返回参数：无

2.5商户入网报备（代理商版）uni.merc.register（开发中）

请求网关需求参数

参数名必填参数使用及详细说明

abbreviationM商户简称（上报支付宝、微信、银联渠道）

企业注册区县（如天心区、长沙县）仅需填写县或区即可；

qy_countyM

不需要填写其他参数，否则无法识别注册地址

account_idM法人结算银行卡号（对公填写公司卡号）

bank_idM必填，开户行联行号

银行卡或对公户开户城市所在区县名称；

bank_countyM

与qy_county相似，填写区或县名称

清分类型（也称结算类型）

bank_typeM1:对私结算，2:对公结算

此处填写整数值1OR2

qy_imgM营业执照图片地址（可访问的网络地址）

sfz_imgzM法人身份证正面地址（可访问的网络地址）

sfz_imgfM法人身份证反面地址（可访问的网络地址）

aucounl_imgM银行K或开户许可证照片（可访问的网络地址）

shop_mtM店铺或工作室门头招牌照片（可访问的网络地址）

shop_njM店铺或工作室内景办公照片或收银台照片（网络地址）

是否启用极速入网（极速入网系统不再校验商户风险，但此

操作带来但风险将会由代理商自行承担责任。此接口权限请

speed0

联系客服人员获取。默认代理商关闭此权限！）

如需极速入网请传输任意值，留空或不传输则不启用！

r_typeM报备类型；1：支付宝，2:微信支付，3:支付宝+微信支付

phoneM法人手机号码（微信实名时使用）

bank_zhihangM银行支行名称

request_array返回参数

参数名参数说明必填参数使用及详细说明

sub_mch_id子商户号0入网子商户号

2.6查询入网结果和状态uni.mer.query

请求网关需求参数

参数名参数说明必填参数使用及详细说明

sub_mch_id子商户号M入网子商户号

requestarray返回参数

参数名参数说明必填参数使用及详细说明

status入网状态M入网商户审核状态

0：待系统处理中，1：审核已通过，2:审核失败，

3:渠道接口其他原因正在审核中

error_msg失败原因0status为2时返回，审核失败原因

info入网信息M入网信息数据（中文数组，此处不详细说明）

2.7商户便捷入网方式（代理商与普通商户通用）

定义：什么是便捷入网？

如代理商不想通过自行开发API对接的情况下，可以使用此方式（代理商程序默认为此方

式），普通商户如不想等待人工入网审核时也可使用此方式！

入网说明：请联系客服人员获取便捷入网的地址，即可正常进行便捷性入网。入网提交后系

统会同步反馈子商户编号用户自行保存并调用API获取信息即可。

温馨提示：便捷入网不支持极速入网的功能权限！

入网地址：

2.8微信实名认证（开户意愿确认接口）wechat.pay.init

请求网关需求参数

参数名参数说明必填参数使用及详细说明

sub_mch_id子商户号M入网子商户号

request_array返回参数

参数名参数说明必填参数使用及详细说明

images实名码crsp_code为0000时返回

2.9同步微信投诉数据wechat.tousu.init

请求网关需求参数：无

requestarray返回参数

参数名参数说明必填参数使用及详细说明

list投诉数组crsp_code为0000时返回

List数组数据

参数名参数说明必填参数使用及详细说明

b