AllPay_Other_Integration_Specification_CH.md 7.0 KB

GoAllPay其他接口文档V1.0.0

上海偶可贝网络科技有限公司

  • 版本信息:中文 V1.0.0
  • 更新时间:2020 年 12 月

1.概述

GoAllPay 为客户提供统一的 API 接入,以帮助客户实现快速、安全、集中式的接入服务。

2.验签说明

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

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

3. 签名过程示例:
String1: merID=000000000000015&signType=MD5&transID=MQkmUGAh3Gw2HEEi
stringSignTemp: merID=000000000000015&signType=MD5&transID=MQkmUGAh3Gw2HEEi2f2c77e3718c47cfb47a89a6fbc9d361
signature: 16d93a9ac6ca89bfdefb018924f11965

3.API 说明

3.1 获取渠道流水信息接口

该接口可通过支付响应中的transID查询渠道流水相关信息。

测试环境地址 生产环境地址
https://testapi.allpayx.com/api/schemaTransId https://api.allpayx.com/api/schemaTransId

1.请求参数

参数 类型 属性 描述
merID String(15) M 商户 ID,由 GoAllPay 分配
transID String(64) M GW 系统生成的交易 ID,由 GoAllPay 系统返回
signType String(10) M MD5或SHA256
signature String(60) M 采用 MD5或SHA256 签名

2.响应参数

参数 类型 属性 描述
merID String(12) M 商户 ID,由 GoAllPay 分配
orderNum String(64) M 商户订单号
allpayOrderNum String(4) M GoAllPay系统的转换商户订单号
schemaTransId String(60) O 支付渠道的交易ID
billCurrency String(3) O 扣账币种:“CNY”。目前只有支付宝和微信有值,其他渠道为空。
billAmount String(12) O 扣账金额:人民币金额。目前只有支付宝和微信有值,其他渠道为空。
truncatePan String(32) O 截断卡号。目前只支持外卡
paymentTime String(14) O 支付完成时间,格式:"yyyyMMddHHmmss"
originalRequest Object O 原始支付请求,数据格式:JSON
originalResponse Object O 原始支付响应,数据格式:JSON
transID String(32) M GW 系统生成的交易 ID,每笔交易保持唯一
paymentSchema String(10) M 渠道代码:点击这里
RespCode String(2) M 应答码 00-成功
RespMsg String(20) M 应答消息

3.2 汇率查询接口

该接口提供银联、微信、支付宝渠道汇率查询的功能。

测试环境地址 生产环境地址
https://test-sapi.allpayx.com/sapi/v1/get_exchange_rate https://sapi.allpayx.com/sapi/v1/get_exchange_rate

1.请求交易参数

参数 属性 描述
pid M 商户 ID,由 GoAllPay 分配
issuer M 汇率的提供机构,取值:UPI银联国际,ALP支付宝,WXP微信支付
original_currency M 源币种,取值:USD,HKD,……
conversion_currency M 转换币种,取值:CNY(当前仅支持CNY)
sign_type M sha256
sign M 签名

2.成功交易返回参数

参数 属性 描述
rate_date M 汇率日期,8位日期格式YYYYMMDD
issuer M 汇率的提供机构,取值:UPI银联国际,ALP支付宝,WXP微信支付
original_currency M 源币种,取值:USD,HKD,……
conversion_currency M 转换币种,取值:CNY(当前仅支持CNY)
exchange_rate M 参考汇率值

3.3 物流信息上传接口

该接口提供物流信息上传功能。

测试环境地址 生产环境地址
https://testapi.allpayx.com/api/logistics https://api.allpayx.com/api/logistics

1.请求参数

参数 类型 属性 描述
version String(12) M "VER000000005"
merID String(15) M 商户 ID,由 GoAllPay 分配
orderNum String(64) M 支付订单号
paymentSchema String(10) M 渠道代码:点击这里
logisticsNo String(64) M 物流单号
logisticsCompany String(64) M 物流公司
signType String(10) M MD5或SHA256
signature String(60) M 采用 MD5或SHA256 签名

2.响应参数

参数 类型 属性 描述
RespCode String(2) M 应答码 00-成功
RespMsg String(20) M 应答消息

4.应答码

应答码 描 述
00 成功
01 失败
U1 商户号不存在
U2 签名错误
U3 报文被篡改
U4 缺失参数
U5 无效的参数
U7 订单不存在
U8 参数为空
U9 系统错误
P4 功能不支持

5.技术支持

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