# GoAllPay在线支付接入规范文档V5.0.0 [上海偶可贝网络科技有限公司](https://www.goallpayx.com) * 版本信息：中文 V5.0.0 * 更新时间：2019 年1 月 ## 1.概述 GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安全、集中式的接入支付渠道。 ## 2.交易流程 ![image](https://git.allpayx.com/OpenAPI/b2c/raw/master/images/pc_flowsheet.png) ## 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 | 渠道代码：[点击查看详情](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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）接口交易流程 ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665470156706.jpg) 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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）接口交易流程 ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665469966231.jpg) 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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）接口交易流程 ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665470092257.jpg) 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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 | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) | | 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.响应报文 商户需要提供一个 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 | 预授权填写“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）接口交易流程 ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665464464405.jpg) 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）接口交易流程 ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665464582903.jpg) 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返回该字段 | ```javascript 测试卡： 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对接文档](https://git.allpayx.com/OpenAPI/common/src/master/v5/android/Android_Integration_Specification_CH.md)调用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. | ```javascript 测试环境配置： 修改测试机器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"} | ```javascript 测试卡： 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 | ```javascript 测试卡： 卡号: 4761340000000019 有效期: 1217 CVV2: 830 卡号: 5204730000002555 有效期: 1225 CVV2: 123 ``` ### 5.11 RevPay渠道 #### 5.11.1 消费/预授权 消费/预授权接口专属字段 | 参数 | 类型 | 属性 | 描述 | | --------- | ------ | ---- | -------- | | tradeFrom | String | M | "H5" | | bankCode | String | M | 银行代码，测试环境填写TEST0021，生产环境[点击此处查看详情](https://git.allpayx.com/OpenAPI/common/src/master/RevPayBankCode.md) | ```javascript 测试卡信息： FPX Test Card Payment ID : 3 Bank Code : TEST0021 Bank Name : SBI Bank A User Id : 1234 Password : 1234 ``` ### 5.12 Gcash渠道 #### 5.12.1 H5支付 消费接口专属字段 | 参数 | 类型 | 属性 | 描述 | | --------- | ------ | ---- | ------- | | tradeFrom | String | M | "H5" | ### 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](https://git.allpayx.com/OpenAPI/common/src/master/countrycode.md). | | 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 EMP_IN渠道 #### 5.14.1 消费 消费/预授权接口专属字段 | 参数 | 类型 | 属性 | 描述 | | --------- | ------ | ---- | ---- | | tradeFrom | String | M | "H5" | | bank_code | String | M |NB或UI | | 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.| | tag | String | M | "online_banking" | ## 6.应答码 | 应答码 | 描 述 | | ------ | --------- | | 00 | 成功 | | 01 | 失败 | | 04 | 处理中 | | 61 | 超过限额 | | U1 | 商户号不存在 | | U2 | 签名错误 | | U3 | 报文被篡改 | | U4 | 缺失参数 | | U5 | 无效的参数 | | U6 | 重复的订单号 | | U7 | 订单不存在 | | U8 | 参数为空 | | U9 | 系统错误 | | P1 | 渠道未配置 | | P2 | 币种未配置 | | P3 | 余额不足 | | P4 | 功能不支持 | | P5 | 渠道返回错误 | ## 7.APP模式对接文档 Android对接文档：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/v5/android/Android_Integration_Specification_CH.md) iOS对接文档：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/v5/ios/iOS_Integration_Specification_CH.md) ## 8.技术支持 如果您在调试时遇到问题，请与我们联系：support@allpayx.com