GoAllPay在线支付接入规范文档V5.0.0

版本信息：中文 V5.0.0
更新时间：2019 年1 月

1.概述

GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安全、集中式的接入支付渠道。

2.交易流程

3.验签说明

1.对于发送到 GoAllPay 系统的请求报文，其中所有传入参数（除 signature 参数外）按照字段名的 ASCII 码从小到大排序后（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2...）拼接成字符串 String1。

2.在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 GoAllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。

3.示例签名串 acqID=99020344&backURL=https://baidu.com&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCIsInF1YW50aXR5IjoiMiJ9LHsiZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCBwbHVzIiwicXVhbnRpdHkiOiI0In1d&frontURL=https://mchapi.allpayx.com/demo&goodsInfo=华为P20&merID=000000000000015&merReserve=你好&orderAmount=1&orderCurrency=HKD&orderNum=dKmdb4S9Tv1a9ZpkMjeDawV82MCJ&paymentSchema=AP&signType=MD5&transTime=20181206134515&transType=PURC&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361

4.通用API说明

商户服务器和 GoAllPay 网关对接的通用接口，每个渠道都具有的功能，包括：消费，消费查询，退款，退款查询。

4.1 通用 API 接入地址

交易名称	测试地址	生产地址
消费	https://testapi.allpayx.com/api/unifiedorder	https://api.allpayx.com/api/unifiedorder
消费查询	https://testapi.allpayx.com/api/orderquery	https://api.allpayx.com/api/orderquery
退款	https://testapi.allpayx.com/api/refund	https://api.allpayx.com/api/refund
退款查询	https://testapi.allpayx.com/api/refundquery	https://api.allpayx.com/api/refundquery
预授权	https://testapi.allpayx.com/api/unifiedorder	https://api.allpayx.com/api/unifiedorder
预授权完成	https://testapi.allpayx.com/api/pauc	https://api.allpayx.com/api/pauc
撤销	https://testapi.allpayx.com/api/canc	https://api.allpayx.com/api/canc
手工退款申请	https://testapi.allpayx.com/api/refdreq	https://api.allpayx.com/api/refdreq
卡片绑定	https://testapi.allpayx.com/api/bindCard	https://api.allpayx.com/api/bindCard
卡片解绑	https://testapi.allpayx.com/api/unBindCard	https://api.allpayx.com/api/unBindCard
绑卡支付	https://testapi.allpayx.com/api/bindPay	https://api.allpayx.com/api/bindPay

4.2 消费交易接口

1.接口说明

该接口为接入商家提供消费购买的功能。

2.请求报文格式

下面列举的字段为通用字段，每个渠道都需要上送，部分渠道有专属字段，具体请到第5章渠道专属配置处查看。消费接口分为跳转型和参数返回型，默认为跳转型，参数返回型会在第5章（渠道专属配置）里面说明。

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	消费交易填写“PURC”
orderNum	String(60)	M	订单号：商户自行定义，需保证同一商户号下订单号不能重复
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
frontURL	String(400)	M	支付完成后跳转到该地址
backURL	String(400)	M	支付结果异步通知到该地址
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击查看详情
goodsInfo	String(60)	M	商品信息,在支付页面上显示。
detailInfo	String(400)	M	商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行base-64编码后签名上送。
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
merReserve	String(1024)	O	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.跳转型消费接口响应报文

商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需响应字符串“OK”。

如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。

推送参数如下表：

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	消费交易填写“PURC”
orderNum	String(60)	M	订单号
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击这里
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
GWTime	String(14)	M	yyyyMMddHHmmss，为 GW 时间
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
merReserve	String(1024)	O	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.3 消费查询交易接口

1.接口说明

该接口为接入商家提供消费查询的功能。

（1）接口补充说明

商户发起消费交易后，可通过该接口查询消费交易的状态

（2）接口交易流程

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	查询填写“INQY”
orderNum	String(60)	M	支付订单号
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击这里
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	查询填写“INQY”
orderNum	String(60)	M	支付订单号
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击这里
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(3)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.4 退款交易接口

1.接口功能说明

该接口为接入商家提供交易退款的功能。

（1）接口补充说明

该接口在消费交易成功后发起，要求指定原订单号
外卡交易当日不能做退款，可以做撤销，只能隔日退款
正常情况下，商户当日退款金额，不得大于当日成功交易额

（2）接口交易流程

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	退款填写“REFD”
orderNum	String(60)	M	退款订单号:商户自行定义，需保证同一商户号下退款订单号不能重复
origOrderNum	String(60)	M	原支付订单号
returnAmount	String(12)	M	退款金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准如：人民币填写“CNY”,美元填写"USD"
merID	String(15)	M	商户 ID，由 GoAllPay 分配
paymentSchema	String(10)	M	渠道代码：点击这里
acqID	String(11)	M	收单行 ID "99020344"
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(3)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	退款填写“REFD”
orderNum	String(60)	M	退款订单号
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击这里
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.5 退款查询交易接口

1.接口说明

该接口为接入商家提供退款查询的功能。

（1）接口补充说明

该接口用于商户在退款发起后，查询退款交易的处理状态

（2）接口交易流程

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	查询填写“RFQY”
orderNum	String(60)	M	退款订单号
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击这里
transTime	String(14)	M	交易时间，格式:"yyyyMMddHHmmss"
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	查询填写“RFQY”
orderNum	String(60)	M	退款订单号
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：点击这里
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.6 外卡预授权接口

1.接口说明

预授权接口适用于外卡交易，包括VISA、万事达、JCB等卡品牌。预授权交易不会参与清算，发卡银行会暂时冻结用户资金。

2.请求报文格式

下面列举的字段为通用字段，每个渠道都需要上送，部分渠道有专属字段，具体请到第5章渠道专属配置处查看。

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	预授权填写“PAUT”
orderNum	String(60)	M	订单号：商户自行定义，需保证同一商户号下订单号不能重复
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
frontURL	String(400)	M	支付完成后跳转到该地址
backURL	String(400)	M	支付结果异步通知到该地址
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
goodsInfo	String(60)	M	商品信息,在支付页面上显示。
detailInfo	String(400)	M	商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行base-64编码后签名上送。
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
merReserve	String(1024)	O	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文

如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。

推送参数如下表：

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	预授权填写“PAUT”
orderNum	String(60)	M	订单号
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
GWTime	String(14)	M	yyyyMMddHHmmss，为 GW 时间
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
merReserve	String(1024)	O	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.7 外卡预授权完成接口

1.接口说明

预授权完成接口适用于外卡交易，包括VISA、万事达、JCB等卡品牌。预授权完成交易与消费交易相似，交易成功后，会对商户进行资金的清算。

（1）接口补充说明

该接口在预授权交易成功后发起，要求指定原预授权订单号，时间相隔最长不超过30天
预授权完成交易金额，不能大于预授权交易金额
预授权交易，只支持一次成功的预授权完成交易

（2）接口交易流程

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	预授权完成填写“PAUC”
orderNum	String(60)	M	订单号：商户自行定义，需保证同一商户号下订单号不能重复
origOrderNum	String(60)	M	原预授权订单号
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	预授权完成填写“PAUC”
orderNum	String(60)	M	预授权完成订单号
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.8 撤销接口

1.接口说明

撤销接口适用于外卡（包括VISA、万事达、JCB等卡品牌）和支付宝菲律宾钱包。

（1）接口补充说明

该接口支持对外卡消费、预授权、预授权完成交易以及支付宝菲律宾钱包的消费交易进行撤消。
对消费进行撤消时，只能支持撤消当日交易（注意：北京时间23:00后，视为隔天）。对于非当日交易，可以通过退款接口进行处理。

（2）接口交易流程

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	填写“VOID”
orderNum	String(60)	M	订单号：商户自行定义，需保证同一商户号下订单号不能重复
origOrderNum	String(60)	M	原交易订单号：要撤销的订单号，可以为消费、预授权、预授权完成的orderNum
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	填写“VOID”
orderNum	String(60)	M	撤销订单号
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.9 外卡手工退款申请接口

1.接口功能说明

对90天之前的交易进行退款，商户无法通过调用联机退款接口处理，需调用该接口发起退款申请，申请成功后我们业务人员会通过人工方式进行处理，处理周期大概在3-5个工作日，退款申请交易经过人工处理后被成功退款，交易才会清算。

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(10)	M	人工退款填写“REFDREQ”
orderNum	String(60)	M	退款申请单号:商户自行定义，需保证同一商户号下退款订单号不能重复
origOrderNum	String(60)	M	原支付订单号
returnAmount	String(12)	M	退款金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准如：人民币填写“CNY”,美元填写"USD"
merID	String(15)	M	商户 ID，由 GoAllPay 分配
paymentSchema	String(10)	M	渠道代码：FC
acqID	String(11)	M	收单行 ID "99020344"
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(3)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	人工退款填写“MANREFD”
orderNum	String(60)	M	退款订单号
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
RespCode	String(2)	M	应答码 00 代表申请已受理
RespMsg	String(20)	M	应答消息
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.10 签约接口

1.接口功能说明

为用户提供绑卡功能

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
transType	String(10)	M	绑卡 "BIND"
orderNum	String(60)	M	绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复
orderCurrency	String(3)	M	订单币种：ISO标准如：人民币填写“CNY”,美元填写"USD"
customerId	String(60)	M	用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复
frontURL	String(400)	M	绑定结果前端跳转地址
backURL	String(400)	M	绑定成功后异步通知到该地址
merID	String(15)	M	商户 ID，由 GoAllPay 分配
paymentSchema	String(10)	M	渠道代码
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
transType	String(10)	M	绑卡 "BIND"
orderNum	String(60)	M	绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
paymentSchema	String(10)	M	渠道代码
RespCode	String(2)	M	应答码 00 代表成功
RespMsg	String(20)	M	应答消息
token	String(32)	O	应答码为 00时返回
customerId	String(60)	O	用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复
cardNoTail	String(4)	O	渠道为FC时返回 ,卡号后四位
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.11 解约接口

1.接口功能说明

解除绑定的卡片

2.请求报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
transType	String(10)	M	绑卡 "UNBIND"
orderNum	String(60)	M	解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复
orderCurrency	String(3)	M	订单币种：ISO标准如：人民币填写“CNY”,美元填写"USD"
customerId	String(60)	M	用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复
token	String(32)	M	绑卡时返回的token
merID	String(15)	M	商户 ID，由 GoAllPay 分配
paymentSchema	String(10)	M	渠道代码
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文格式

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
transType	String(10)	M	绑卡 "UNBIND"
orderNum	String(60)	M	解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
merID	String(15)	M	商户 ID，由 GoAllPay 分配
paymentSchema	String(10)	M	渠道代码
RespCode	String(2)	M	应答码 00 代表成功
RespMsg	String(20)	M	应答消息
customerId	String(60)	M	用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复
cardNoTail	String(4)	M	卡号后四位,渠道为FC时返回
token	String(32)	M	token
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
GWTime	String(14)	M	YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

4.12 订阅扣款接口

1.接口功能说明

绑卡消费支付,根据绑卡时返回的token,对用户进行扣款

2.请求报文格式

下面列举的字段为通用字段，每个渠道都需要上送，部分渠道有专属字段，具体请到第5章渠道专属配置处查看。

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	消费填写“PURC”
orderNum	String(60)	M	订单号：商户自行定义，需保证同一商户号下订单号不能重复
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
backURL	String(400)	M	支付结果异步通知到该地址
customerId	String(60)	M	用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复
token	String(32)	M	绑卡时返回的token
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码
detailInfo	String(400)	M	商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行base-64编码后签名上送。
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
merReserve	String(1024)	O	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

3.响应报文

参数	类型	属性	描述
version	String(12)	M	统一填写为“VER000000005”
charSet	String(6)	M	统一填写为“UTF-8”
transType	String(4)	M	消费填写“PURC”
orderNum	String(60)	M	订单号
orderAmount	String(12)	M	订单金额：如 100 元，表示为 100 或 100.00
orderCurrency	String(3)	M	订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
merID	String(15)	M	商户 ID，由 GoAllPay 分配
acqID	String(11)	M	收单行 ID "99020344"
paymentSchema	String(10)	M	渠道代码：FC
RespCode	String(2)	M	应答码 00-成功，01-失败。详情见本文档第6章应答码
RespMsg	String(20)	M	应答消息
transID	String(32)	M	GW 系统生成的交易 ID，每笔交易保持唯一
GWTime	String(14)	M	yyyyMMddHHmmss，为 GW 时间
transTime	String(14)	M	交易时间，格式："yyyyMMddHHmmss"
merReserve	String(1024)	O	商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。
signType	String(10)	M	MD5或SHA256
signature	String(32)	M	采用 MD5或SHA256 签名

5.渠道专属配置

5.1 WX渠道

5.1.1 二维码无跳转模式

该模式返回生成二维码的字符串，商户需要自己生成二维码。

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该字段

5.1.2 二维码跳转模式

该模式会为商户跳转到GoAllPay生成好的二维码页面，无需商户自己生成。

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"QUICK"

5.1.3 公众号支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"JSAPI"

5.1.4 小程序支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APPLET"
openid	String	M	微信openid

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
sdk_params	String	O	小程序支付所需参数（JSON字符串）。应答码为00返回该字段

将上述返回数据放入微信小程序支付接口，即可调起微信小程序支付，具体方法，参考微信小程序API

5.1.5 APP支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APP"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

获取到tn后，根据本文档第7节调用SDK进行支付。

5.2 AP渠道

5.2.1 WebSite支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"WEB"

5.2.2 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"JSAPI"

5.2.3 APP支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APP"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

获取到tn后，根据本文档第7节调用SDK进行支付。

5.2.4 二维码无跳转模式

该模式返回生成二维码的字符串，商户需要自己生成二维码。

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该字段

5.3 UP渠道

5.3.1 H5支付,自适应PC和移动端

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"

5.3.2 APP支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APP"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

获取到tn后，根据本文档第7节调用SDK进行支付。

5.3.3 二维码无跳转模式

该模式返回生成二维码的字符串，商户需要自己生成二维码。

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该字段

测试卡：

Credit card：8171999927660000
mobile：+852 11112222
cvn2:  123
exp date: month 12 year 30
SMS Code on PC: 111111
SMS Code on Mobile: 123456

5.4 Apple Pay渠道

5.4.1 APP支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APP"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

获取到tn后，根据本文档第7节调用SDK进行支付。

5.5 CA渠道

5.5.1 APP支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APP"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

获取到tn后，根据Android对接文档调用SDK进行支付

5.6 MIPAY渠道

5.6.1 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
firstname	String	M	This is name of the customer who is doing the transaction.
email	String	M	this is email id of the customer who is doing transaction
phone	String	M	Phone number of the customer
customerId	String	O	Customer ID, when client register on merchant, merchant distribute it to client.

测试环境配置：

修改测试机器hosts,添加如下两条信息
114.80.87.249 account.preview.n.xiaomi.net
114.80.87.249 api.account.preview.n.xiaomi.net

测试卡：

卡号：5123456789012346
有效期：0520
cvv：123

5.7 EB渠道

5.7.1 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
firstname	String	M	This is name of the customer who is doing the transaction.
email	String	M	this is email id of the customer who is doing transaction
phone	String	M	Phone number of the customer

5.8 PF渠道

5.8.1 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
showShipAddr	String	M	"1"：显示账单填写表单, "0"：不显示账单填写表单
shipAddr	String	O	shipAddr=base64(json) {"first_name":"wei","last_name":"wei","street":"address_line1","house_number":"address_line2","address_city":"new york","address_state":"new york","country_id":"us","address_zip":"10022","phone_num":"13512345678","email_address":"123@126.com"}

测试卡：

Card Number: 5101180000000007
Expriation Date: 1020
CVC: 737

5.9 APHK渠道

5.9.1 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"JSAPI"

5.9.2 二维码无跳转模式

该模式返回生成二维码的字符串，商户需要自己生成二维码。

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该字段

5.9.3 APP支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"APP"

应答报文：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

获取到tn后，根据本文档第7节调用SDK进行支付。

5.10 FC渠道

5.10.1 消费/预授权

消费/预授权接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"

5.10.2 签约绑卡支付

绑卡分两种模式

(1) 用户在商户平台选择添加卡，然后跳转至GoAllPay的绑卡页面，用户在此页面输入卡号信息.绑卡失败,则返失败通知给商户；绑卡成功，返一个“token+customer ID+卡号后四位”给商户。

方式一专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"

(2)商户自己收集卡号信息通过API送到GoAllPay网关.

方式二专属字段

参数	类型	属性	描述
tradeFrom	String	M	"API"
cardno	String	M	卡号
cvv2	String	M	cvv2
ExpiryDate	String	M	有效期:格式 MM/YY

测试卡：

卡号: 4761340000000019
有效期: 1217
CVV2: 830

卡号: 5204730000002555
有效期: 1225
CVV2: 123

5.11 RevPay渠道

5.11.1 消费/预授权

消费/预授权接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
bankCode	String	M	银行代码，测试环境填写TEST0021，生产环境点击此处查看详情

测试卡信息：
FPX Test Card
Payment ID : 3
Bank Code : TEST0021
Bank Name : SBI Bank A
User Id : 1234
Password : 1234

5.12 AliPayLocal渠道

5.12.1 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
sub_brand_code	String	M	["gcash","dana"]选其中一个上送

5.13 PO渠道

5.13.1 H5支付

消费接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
countrycode	String	M	The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see payment method specific documentation.
accountholdername	String	M	The account holder - minimum of 3 characters, up to 100 charac- ters.
tag	String	M	取值如下：directpay, boleto, webpay, trustpay, skrill, singpost, sepaddmodela, safetypay, qiwi, p24, poli, paysafecard, mybank, itau, ideal, hipercard, giropay, eps, enets, dragonpay, bancodobrasil, baloto, aura, payu

5.13.1.1 当 tag 为 paysafecard 时，还需另外增加下面字段

参数	类型	属性	描述
consumerref	String	M	Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20}

5.13.1.2 当 tag 为 aura, baloto, bancodobrasil, boleto, hipercard, itau, webpay 时，还需另外增加下面字段

参数	类型	属性	描述
consumerref	String	M	Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20}
nationalid	String	M	Consumer’s national id (up to 30 characters)
email	String	M	RFC compliant email address of the account holder
address	String	M	Consumer's address
zipcode	String	M	Consumer's zip/postal code
dob	String	O	Date of birth, format YYYYMMDD

5.13.1.3 当 tag 为 dragonpay, enets, singpost 时，还需另外增加下面字段

参数	类型	属性	描述
email	String	M	RFC compliant email address of the account holder
phone	String	M	Valid international phone number of the account holder

5.13.1.4 当 tag 为 giropay, directpay 时，还需另外增加下面字段

参数	类型	属性	描述
bic	String	O	Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank

5.13.1.5 当 tag 为 payu, p24, safetypay 时，还需另外增加下面字段

参数	类型	属性	描述
email	String	M	RFC compliant email address of the account holder

5.13.1.6 当 tag 为 qiwi 时，还需另外增加下面字段

参数	类型	属性	描述
mobilephone	String	M	Valid international Russian mobile phone number identifying the QIWI destination account to pay out to (excluding plus sign or any other international prefixes, including a leading 7 for Russia, 11 digits in total, e.g. 71234567890).
siteid	String	M	Unique site identifier, forwarded to qiwi. Required for clients serving multiple points of sale.

5.13.1.7 当 tag 为 skrill 时，还需另外增加下面字段

参数	类型	属性	描述
email	String	O	RFC compliant email address of the account holder
address	String	O	Consumer's address
zipcode	String	O	Consumer's zip/postal code
city	String	O	Consumer’s city

5.13.1.8 当 tag 为 sepaddmodela 时，还需另外增加下面字段

参数	类型	属性	描述
email	String	M	RFC compliant email address of the account holder
iban	String	M	Valid IBAN

5.14 India_Netbanking渠道

5.14.1 消费

消费/预授权接口专属字段

参数	类型	属性	描述
tradeFrom	String	M	"H5"
bank_code	String	M	见列表
email	String	M	Must contain valid e-mail of customer
phone	String	M	Must contain valid phone number of customer
firstname	String	M	Customer first name
lastname	String	M	Customer last name
address	String	M	address
zip_code	String	M	ZIP code
city	String	M	City
country	String	M	Country code in ISO 3166
state	String	M	State code in ISO 3166-2, required for USA and Canada
document_id	String	M	Document ID of the consumer.

Bank Name	Bank Code
Aditya Birla Idea Payments Bank	ABPB
Airtel Payments Bank	AIRP
Allahabad Bank	ALLA
Andhra Bank	ANDB
Bank of Baroda - Retail Banking	BARB_R
Bank of Bahrein and Kuwait	BBKM
Dena Bank	BKDN
Bank of India	BKID
Central Bank of India	CBIN
City Union Bank	CIUB
Canara Bank	CNRB
Corporation Bank	CORP
Cosmos Co-operative Bank	COSB
Catholic Syrian Bank	CSBK
Development Bank of Singapore	DBSS
DCB Bank	DCBL
Deutsche Bank	DEUT
Dhanlaxmi Bank	DLXB
Equitas Small Finance Bank	ESFB
Federal Bank	FDRL
HDFC Bank	HDFC
IDBI	IBKL
ICICI Bank	ICIC
IDFC FIRST Bank	IDFB
Indian Bank	IDIB
Indusind Bank	INDB
Indian Overseas Bank	IOBA
Jammu and Kashmir Bank	JAKA
Janata Sahakari Bank (Pune)	JSBP
Karnataka Bank	KARB
Kotak Mahindra Bank	KKBK
Karur Vysya Bank	KVBL
Lakshmi Vilas Bank - Corporate Banking	LAVB_C
Lakshmi Vilas Bank - Retail Banking	LAVB_R
Bank of Maharashtra	MAHB
NKGSB Co-operative Bank	NKGS
Oriental Bank of Commerce	ORBC
Punjab & Maharashtra Co-operative Bank	PMCB
Punjab & Sind Bank	PSIB
Punjab National Bank - Retail Banking	PUNB_R
RBL Bank	RATN
State Bank of Bikaner and Jaipur	SBBJ
State Bank of Hyderabad	SBHY
State Bank of India	SBIN
State Bank of Mysore	SBMY
State Bank of Travancore	SBTR
Standard Chartered Bank	SCBL
South Indian Bank	SIBL
Saraswat Co-operative Bank	SRCB
State Bank of Patiala	STBP
Shamrao Vithal Co-operative Bank	SVCB
Syndicate Bank	SYNB
Tamilnadu Mercantile Bank	TMBL
Tamilnadu State Apex Co-operative Bank	TNSC
Union Bank of India	UBIN
UCO Bank	UCBA
United Bank of India	UTBI
Axis Bank	UTIB
Vijaya Bank	VIJB
Yes Bank	YESB

6.应答码

应答码	描述
00	成功
01	失败
04	处理中
61	超过限额
U1	商户号不存在
U2	签名错误
U3	报文被篡改
U4	缺失参数
U5	无效的参数
U6	重复的订单号
U7	订单不存在
U8	参数为空
U9	系统错误
P1	渠道未配置
P2	币种未配置
P3	余额不足
P4	功能不支持
P5	渠道返回错误

7.APP模式对接文档

Android对接文档：点击这里

iOS对接文档：点击这里

8.技术支持

如果您在调试时遇到问题，请与我们联系：support@allpayx.com

AllPay_Integration_Specification_CH.md 70 KB Historia Raaka

GoAllPay在线支付接入规范文档V5.0.0

1.概述

2.交易流程

3.验签说明

4.通用API说明

4.1 通用 API 接入地址

4.2 消费交易接口

4.3 消费查询交易接口

4.4 退款交易接口

4.5 退款查询交易接口

4.6 外卡预授权接口

4.7 外卡预授权完成接口

4.8 撤销接口

4.9 外卡手工退款申请接口

4.10 签约接口

4.11 解约接口

4.12 订阅扣款接口

5.渠道专属配置

5.1 WX渠道

5.1.1 二维码无跳转模式

5.1.2 二维码跳转模式

5.1.3 公众号支付

5.1.4 小程序支付

5.1.5 APP支付

5.2 AP渠道

5.2.1 WebSite支付

5.2.2 H5支付

5.2.3 APP支付

5.2.4 二维码无跳转模式

5.3 UP渠道

5.3.1 H5支付,自适应PC和移动端

5.3.2 APP支付

5.3.3 二维码无跳转模式

5.4 Apple Pay渠道

5.4.1 APP支付

5.5 CA渠道

5.5.1 APP支付

5.6 MIPAY渠道

5.6.1 H5支付

5.7 EB渠道

5.7.1 H5支付

5.8 PF渠道

5.8.1 H5支付

5.9 APHK渠道

5.9.1 H5支付

5.9.2 二维码无跳转模式

5.9.3 APP支付

5.10 FC渠道

5.10.1 消费/预授权

5.10.2 签约绑卡支付

5.11 RevPay渠道

5.11.1 消费/预授权

5.12 AliPayLocal渠道

5.12.1 H5支付

5.13 PO渠道

5.13.1 H5支付

5.13.1.1 当 tag 为 paysafecard 时，还需另外增加下面字段

5.13.1.2 当 tag 为 aura, baloto, bancodobrasil, boleto, hipercard, itau, webpay 时，还需另外增加下面字段

5.13.1.3 当 tag 为 dragonpay, enets, singpost 时，还需另外增加下面字段

5.13.1.4 当 tag 为 giropay, directpay 时，还需另外增加下面字段

5.13.1.5 当 tag 为 payu, p24, safetypay 时，还需另外增加下面字段

5.13.1.6 当 tag 为 qiwi 时，还需另外增加下面字段

5.13.1.7 当 tag 为 skrill 时，还需另外增加下面字段

5.13.1.8 当 tag 为 sepaddmodela 时，还需另外增加下面字段

5.14 India_Netbanking渠道

5.14.1 消费

6.应答码

7.APP模式对接文档

8.技术支持

AllPay_Integration_Specification_CH.md 70 KB

Historia Raaka