AllPay_Other_Integration_Specification_CH.md 5.0 KB

AllPay其他接口文档V1.0.0

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

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

1.概述

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

2.验签说明

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

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

3.示例签名串  merID=000000000000015&signType=MD5&transID=MQkmUGAh3Gw2HEEi2f2c77e3718c47cfb47a89a6fbc9d361

3.API 说明

3.1 汇率查询接口

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

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

1.请求交易参数

参数 属性 描述
pid M 商户 ID,由 AllPay 分配
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.2 获取渠道流水信息接口

该接口提供通过transID查询渠道流水的功能。

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

1.请求参数

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

2.响应参数

参数 类型 属性 描述
merID String(12) M 商户 ID,由AllPay 分配
orderNum String(6) M 商户订单号
allpayOrderNum String(4) M AllPay系统的转换商户订单号
schemaTransId String(60) M 支付渠道的交易ID
transID String(32) M GW 系统生成的交易 ID,每笔交易保持唯一
paymentSchema String(10) M 渠道代码:点击这里
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