GoAllPay 为客户提供统一的API接入,以帮助客户实现快速、安全、集中式的接入支付渠道。
1. 将所有传入参数(除 signature 参数外)按照参数名的 ASCII 码从小到大排序后(字典序),使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。
2. 在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 Key(接入 GoAllPay 时分配),得到 stringSignTemp 字符串,并对 stringSignTemp 进行加密运算(加密算法以参数signType值为准),得到 signature 的值。
3. 签名过程示例:
String1: OsType=WINDOWS&OsVersion=10.0.19043&acqID=99020344&backURL=http://test.com/notify&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6ImlQaG9uZSBYIiwicXVhbnRpdHkiOiIyIn0seyJnb29kc19uYW1lIjoiaVBob25lIDgiLCJxdWFudGl0eSI6IjQifV0=&frontURL=http://test.com/return&goodsInfo=apple&merID=000000000000015&merReserve=yuliu&orderAmount=1&orderCurrency=CNY&orderNum=20211025163735&paymentSchema=UP&signType=MD5&tradeFrom=H5&transTime=20211025163735&transType=PURC&version=VER000000005
stringSignTemp: OsType=WINDOWS&OsVersion=10.0.19043&acqID=99020344&backURL=http://test.com/notify&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6ImlQaG9uZSBYIiwicXVhbnRpdHkiOiIyIn0seyJnb29kc19uYW1lIjoiaVBob25lIDgiLCJxdWFudGl0eSI6IjQifV0=&frontURL=http://test.com/return&goodsInfo=apple&merID=000000000000015&merReserve=yuliu&orderAmount=1&orderCurrency=CNY&orderNum=20211025163735&paymentSchema=UP&signType=MD5&tradeFrom=H5&transTime=20211025163735&transType=PURC&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
signature: 0be23be18fb6148572e15f9fa2f97816
请求方式:POST
数据格式:JSON
测试主机:https://testapi.allpayx.com
生产主机:https://api.allpayx.com
API名称 | URL路径 |
---|---|
支付 | /api/createorder |
查询 | /api/orderquery |
退款 | /api/refund |
预授权 | /api/createorder |
预授权完成 | /api/pauc |
撤销 | /api/canc |
手工退款申请 | /api/refdreq |
签约 | /api/bindCard |
订阅扣款 | /api/bindPay |
解约 | /api/unBindCard |
1. 接口说明
该接口为接入商家提供消费购买的功能。
2. 请求参数
由通用参数和渠道专属参数组成,凡是上送参数都需参与签名。
渠道专属参数: 点击查看
通用参数:
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
paymentSchema | String(10) | 是 | 渠道ID:点击查看详情 |
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 消费交易填写“PURC” |
orderNum | String(60) | 是 | 订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
orderAmount | String(12) | 是 | 订单金额:如 100 元,表示为 100 或 100.00 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD" |
frontURL | String(400) | 是 | 支付完成后前端跳转到该URL |
backURL | String(400) | 是 | 支付结果异步通知到该URL。支付成功后,GoAllPay 会以 POST 方式调用 backURL 通知支付结果(详见回调参数)。商户在接收到通知后,需响应字符串“OK”。 如果没有收到商户响应“OK”,GoAllPay将会过一段时间后重新推送,时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400],单位为秒。 |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
acqID | String(11) | 是 | 收单行 ID,统一填写为"99020344" |
goodsInfo | String(60) | 是 | 商品信息。注意不要包含特殊符号,如 "#","&","+" 等 |
detailInfo | String(400) | 是 | 商品明细。 格式:[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}],需Base64编码后上送。注意goods_name不要包含特殊符号,如 "#","&","+" 等 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
merReserve | String(1024) | 否 | 预留内容,商户自定义。注意不要包含特殊符号,如 "#","&","+" 等 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
OsType | String(20) | 是 | 操作系统类型。 "IOS","ANDROID","HARMONYOS","WINDOWS","MAC","OTHER" 选其中一个上送 |
OsVersion | String(20) | 否 | 操作系统版本。示例:"10.0.19043" |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
RespCode | String(2) | 是 | 应答码,00表示请求成功 |
RespMsg | String(256) | 是 | 应答信息 |
merID | String(15) | 否 | 商户ID |
orderNum | String(60) | 否 | 订单号 |
transID | String(32) | 否 | GoAllPay流水号 |
parameter | Object | 否 | 支付相关参数。RespCode为00且非后台支付模式时返回,返回值详见渠道专属参数 |
4. 回调参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “PURC” |
orderNum | String(60) | 是 | 订单号 |
orderAmount | String(12) | 是 | 订单金额 |
orderCurrency | String(3) | 是 | 订单币种 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transID | String(32) | 是 | GoAllPay流水号 |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
merReserve | String(1024) | 否 | 商户预留内容 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
该接口为接入商家提供订单查询的功能。
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 查询填写“INQY” |
orderNum | String(60) | 是 | 订单号 |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | 交易类型 |
orderNum | String(60) | 是 | 订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口功能说明
该接口为接入商家提供交易退款的功能。
(1)接口补充说明
(2)接口交易流程
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 退款填写“REFD” |
orderNum | String(60) | 是 | 退款订单号:商户自行定义,需保证同一商户号下退款订单号不能重复 |
origOrderNum | String(60) | 是 | 原支付订单号 |
returnAmount | String(12) | 是 | 退款金额:如 100 元,表示为 100 或 100.00 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准 如:人民币填写“CNY”,美元填写"USD" |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “REFD” |
orderNum | String(60) | 是 | 退款订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
预授权接口适用于外卡(包括VISA、万事达、JCB等卡品牌)和银联卡交易。预授权交易不会参与清算,发卡银行会暂时冻结用户资金。
2. 请求参数
由通用参数和渠道专属参数组成。凡是上送参数都需参与签名。
渠道专属参数: 点击查看
通用参数:
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 预授权填写“PAUT” |
orderNum | String(60) | 是 | 订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
orderAmount | String(12) | 是 | 订单金额:如 100 元,表示为 100 或 100.00 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD" |
frontURL | String(400) | 是 | 支付完成后跳转到该地址 |
backURL | String(400) | 是 | 支付结果异步通知到该URL。支付成功后,GoAllPay 会以 POST 方式调用 backURL 通知支付结果(详见回调参数)。商户在接收到通知后,需响应字符串“OK”。 如果没有收到商户响应“OK”,GoAllPay将会过一段时间后重新推送,时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400],单位为秒。 |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
goodsInfo | String(60) | 是 | 商品信息。注意不要包含特殊符号,如 "#","&","+" 等 |
detailInfo | String(400) | 是 | 商品明细。 格式:[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}],需Base64编码后上送。注意goods_name不要包含特殊符号,如 "#","&","+" 等 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
merReserve | String(1024) | 否 | 预留内容,商户自定义。注意不要包含特殊符号,如 "#","&","+" 等 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
RespCode | String(2) | 是 | 应答码,00表示请求成功 |
RespMsg | String(256) | 是 | 应答信息 |
merID | String(15) | 否 | 商户ID |
orderNum | String(60) | 否 | 订单号 |
transID | String(32) | 否 | GoAllPay流水号 |
parameter | Object | 否 | 支付相关参数,RespCode为00时返回 |
4. 回调参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “PAUT” |
orderNum | String(60) | 是 | 订单号 |
orderAmount | String(12) | 是 | 订单金额 |
orderCurrency | String(3) | 是 | 订单币种 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transID | String(32) | 是 | GoAllPay流水号 |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
merReserve | String(1024) | 否 | 商户预留内容 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
预授权完成接口适用于外卡(包括VISA、万事达、JCB等卡品牌)和银联卡交易。预授权完成交易与消费交易相似,交易成功后,会对商户进行资金的清算。
(1)接口补充说明
(2)接口交易流程
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 预授权完成填写“PAUC” |
orderNum | String(60) | 是 | 订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
origOrderNum | String(60) | 是 | 原预授权订单号 |
orderAmount | String(12) | 是 | 订单金额:如 100 元,表示为 100 或 100.00 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD" |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “PAUC” |
orderNum | String(60) | 是 | 预授权完成订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
撤销接口适用于外卡(包括VISA、万事达、JCB等卡品牌)、银联卡和支付宝菲律宾钱包。
(1)接口补充说明
(2)接口交易流程
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 填写“VOID” |
orderNum | String(60) | 是 | 订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
origOrderNum | String(60) | 是 | 原交易订单号:要撤销的订单号,可以为消费、预授权、预授权完成的orderNum |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “VOID” |
orderNum | String(60) | 是 | 撤销订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
对90天之前的交易进行退款,商户无法通过调用联机退款接口处理,需调用该接口发起退款申请,申请成功后我们业务人员会通过人工方式进行处理,处理周期大概在3-5个工作日,退款申请交易经过人工处理后被成功退款,交易才会清算。
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 人工退款填写“REFDREQ” |
orderNum | String(60) | 是 | 退款申请单号:商户自行定义,需保证同一商户号下退款订单号不能重复 |
origOrderNum | String(60) | 是 | 原支付订单号 |
returnAmount | String(12) | 是 | 退款金额:如 100 元,表示为 100 或 100.00 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准 如:人民币填写“CNY”,美元填写"USD" |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “REFDREQ” |
orderNum | String(60) | 是 | 退款订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00 代表申请已受理 |
RespMsg | String(20) | 是 | 应答消息 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
为用户提供签约功能,适用于外卡、银联卡、支付宝本地支付。
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
transType | String(10) | 是 | 绑卡 "BIND" |
orderNum | String(60) | 是 | 绑卡订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD" |
customerId | String(60) | 是 | 用户ID: 商户自行定义,需保证同一商户号下不同用户不能重复 |
frontURL | String(400) | 是 | 绑定后前端跳转地址 |
backURL | String(400) | 是 | 绑定结果异步通知到该URL。绑定成功后,GoAllPay 会以 POST 方式调用 backURL 通知支付结果(详见回调参数)。商户在接收到通知后,需响应字符串“OK”。 如果没有收到商户响应“OK”,GoAllPay将会过一段时间后重新推送,时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400],单位为秒。 |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
tradeFrom | String(20) | 是 | 场景,绑卡:"PAN-BINGDING" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
transType | String(10) | 是 | "BIND" |
orderNum | String(60) | 是 | 绑卡订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00 代表成功 |
RespMsg | String(20) | 是 | 应答消息 |
token | String(32) | 否 | 应答码为 00时返回 |
customerId | String(60) | 否 | 用户ID |
cardNoTail | String(4) | 否 | 渠道为FC时返回,卡号后四位 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口说明
订阅消费,根据绑卡时返回的token,对用户进行扣款
2. 请求参数
由通用参数和渠道专属参数组成。凡是上送参数都需参与签名。
渠道专属参数: 点击查看
通用参数:
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
charSet | String(6) | 是 | 统一填写为“UTF-8” |
transType | String(10) | 是 | 消费填写“PURC” |
orderNum | String(60) | 是 | 订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
orderAmount | String(12) | 是 | 订单金额:如 100 元,表示为 100 或 100.00 |
orderCurrency | String(3) | 是 | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD" |
backURL | String(400) | 是 | 支付结果异步通知到该URL。支付成功后,GoAllPay 会以 POST 方式调用 backURL 通知支付结果(详见回调参数)。商户在接收到通知后,需响应字符串“OK”。 如果没有收到商户响应“OK”,GoAllPay将会过一段时间后重新推送,时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400],单位为秒。 |
customerId | String(60) | 是 | 用户ID: 商户自行定义,需保证同一商户号下不同用户不能重复 |
token | String(32) | 是 | 绑卡时返回的token |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
goodsInfo | String(60) | 是 | 商品信息。注意不要包含特殊符号,如 "#","&","+" 等 |
detailInfo | String(400) | 是 | 商品明细。 格式:[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}],需Base64编码后上送。注意goods_name不要包含特殊符号,如 "#","&","+" 等 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
tradeFrom | String(20) | 是 | 场景,绑卡:"PAN-BINGDING" |
merReserve | String(1024) | 否 | 预留内容,商户自定义。注意不要包含特殊符号,如 "#","&","+" 等 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
charSet | String(6) | 是 | “UTF-8” |
transType | String(10) | 是 | “PURC” |
orderNum | String(60) | 是 | 订单号 |
orderAmount | String(12) | 是 | 订单金额 |
orderCurrency | String(3) | 是 | 订单币种 |
merID | String(15) | 是 | 商户 ID |
acqID | String(11) | 是 | 收单行 ID "99020344" |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00-成功,01-失败。详情见本文档第5章应答码 |
RespMsg | String(20) | 是 | 应答消息 |
transID | String(32) | 是 | GoAllPay流水号 |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
merReserve | String(1024) | 否 | 商户预留内容 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
1. 接口功能说明
解除绑定的卡片
2. 请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | 统一填写为“VER000000005” |
transType | String(10) | 是 | 绑卡 "UNBIND" |
orderNum | String(60) | 是 | 解绑订单号:商户自行定义,需保证同一商户号下订单号不能重复 |
customerId | String(60) | 是 | 用户ID: 商户自行定义,需保证同一商户号下不同用户不能重复 |
token | String(32) | 是 | 绑卡时返回的token |
merID | String(15) | 是 | 商户 ID,由 GoAllPay 分配 |
paymentSchema | String(10) | 是 | 渠道ID:点击这里 |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
tradeFrom | String(20) | 是 | 场景,绑卡:"PAN-BINGDING" |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
3. 响应参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
version | String(12) | 是 | “VER000000005” |
transType | String(10) | 是 | "UNBIND" |
orderNum | String(60) | 是 | 解绑订单号 |
transID | String(32) | 是 | GoAllPay流水号 |
merID | String(15) | 是 | 商户 ID |
paymentSchema | String(10) | 是 | 渠道ID |
RespCode | String(2) | 是 | 应答码 00 代表成功 |
RespMsg | String(20) | 是 | 应答消息 |
customerId | String(60) | 否 | 用户ID |
cardNoTail | String(4) | 否 | 卡号后四位,渠道为FC时返回 |
token | String(32) | 否 | token |
transTime | String(14) | 是 | 交易时间,格式:"yyyyMMddHHmmss" |
GWTime | String(14) | 是 | yyyyMMddHHmmss,为 GW 时间,目前为本地交易时间 |
signType | String(10) | 是 | MD5或SHA256 |
signature | String(32) | 是 | 采用 MD5或SHA256 签名 |
应答码 | 描述 |
---|---|
00 | 成功 |
01 | 失败 |
04 | 处理中 |
61 | 超过限额 |
U1 | 商户号不存在 |
U2 | 签名错误 |
U3 | 请求被篡改 |
U4 | 缺失参数 |
U5 | 无效的参数 |
U6 | 重复的订单号 |
U7 | 订单不存在 |
U8 | 参数为空 |
U9 | 系统错误 |
P1 | 渠道未配置 |
P2 | 币种未配置 |
P3 | 余额不足 |
P4 | 功能不支持 |
P5 | 渠道返回错误 |
A3 | 渠道商户不存在 |
Android对接文档:点击这里
iOS对接文档:点击这里
如果您在调试时遇到问题,请与我们联系:support@allpayx.com