|
|
@@ -2,14 +2,14 @@
|
|
|
[上海偶可贝网络科技有限公司](https://www.goallpayx.com)
|
|
|
|
|
|
* 版本信息：中文 V1.0.0
|
|
|
-* 更新时间：2020 年 12 月
|
|
|
+* 更新时间：2021 年 8 月
|
|
|
|
|
|
-## 1.概述
|
|
|
+## 1. 概述
|
|
|
|
|
|
GoAllPay 为客户提供统一的 API 接入，以帮助客户实现快速、安全、集中式的接入服务。
|
|
|
|
|
|
-## 2.验签说明
|
|
|
-```
|
|
|
+## 2. 签名规则
|
|
|
+```html
|
|
|
1. 对于发送到 GoAllPay 系统的请求报文，其中所有传入参数（除 signature 参数外）按照字段名的 ASCII 码从小到大排序后（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2...）拼接成字符串 String1。
|
|
|
|
|
|
2. 在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 GoAllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。
|
|
|
@@ -20,11 +20,11 @@ stringSignTemp: merID=000000000000015&signType=MD5&transID=MQkmUGAh3Gw2HEEi2f2c7
|
|
|
signature: 16d93a9ac6ca89bfdefb018924f11965
|
|
|
```
|
|
|
|
|
|
-## 3.API 说明
|
|
|
+## 3. API 说明
|
|
|
|
|
|
### 3.1 获取渠道流水信息接口
|
|
|
|
|
|
-该接口可通过支付响应中的transID查询渠道流水相关信息。
|
|
|
+该接口可通过支付响应中的transID查询渠道流水相关信息。支持 GET / POST 请求
|
|
|
|
|
|
| 测试环境地址 | 生产环境地址 |
|
|
|
| --------------------------------------------- | ----------------------------------------- |
|
|
|
@@ -60,41 +60,35 @@ signature: 16d93a9ac6ca89bfdefb018924f11965
|
|
|
|
|
|
### 3.2 汇率查询接口
|
|
|
|
|
|
-该接口提供银联、微信、支付宝渠道汇率查询的功能。
|
|
|
+该接口提供银联、微信、支付宝渠道汇率查询的功能。仅支持 GET 请求
|
|
|
|
|
|
| 测试环境地址 | 生产环境地址 |
|
|
|
| --------------------------------------------- | ----------------------------------------- |
|
|
|
| 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.成功交易返回参数
|
|
|
+1.请求参数
|
|
|
|
|
|
-| 参数 | 属性 | 描述 |
|
|
|
-| --------- | ---- | ------------------------------------- |
|
|
|
-| rate_date | M | 汇率日期，8位日期格式YYYYMMDD |
|
|
|
-| issuer | M | 汇率的提供机构，取值：UPI银联国际，ALP支付宝，WXP微信支付 |
|
|
|
-| original_currency | M | 源币种，取值：USD，HKD，…… |
|
|
|
-| conversion_currency | M | 转换币种，取值：CNY（当前仅支持CNY） |
|
|
|
-| exchange_rate | M | 参考汇率值 |
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| --------- |---- | ---- | ------------------------------------- |
|
|
|
+| pid | String(12) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| issuer | String(3) | M | 汇率的提供机构，取值：UPI银联国际，ALP支付宝，WXP微信支付 |
|
|
|
+| original_currency | String(3) | M | 源币种，取值：USD，HKD，…… |
|
|
|
+| conversion_currency | String(3) | M | 转换币种，取值：微信、支付宝当前仅支持CNY；银联支持CNY，USD |
|
|
|
+| sign_type | String(6) | M | sha256 |
|
|
|
+| sign | String(60) | M | 签名 |
|
|
|
|
|
|
+2.响应参数
|
|
|
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| --------- | ---- | ---- | ------------------------------------- |
|
|
|
+| status | String(30) | M |响应状态 |
|
|
|
+| message | String(30) | M | 响应信息 |
|
|
|
+| data | Object | O | 汇率数据<br>字段详情：<br>rate_date：汇率日期，8位日期格式YYYYMMDD<br>issuer：汇率的提供机构，取值：UPI银联国际，ALP支付宝，WXP微信支付<br>original_currency：源币种<br>conversion_currency：转换币种<br>exchange_rate：参考汇率值 |
|
|
|
|
|
|
### 3.3 物流信息上传接口
|
|
|
|
|
|
该接口提供物流信息上传功能。
|
|
|
|
|
|
-
|
|
|
-
|
|
|
| 测试环境地址 | 生产环境地址 |
|
|
|
| ----------------------------------------- | ------------------------------------- |
|
|
|
| https://testapi.allpayx.com/api/logistics | https://api.allpayx.com/api/logistics |
|
|
|
@@ -114,16 +108,12 @@ signature: 16d93a9ac6ca89bfdefb018924f11965
|
|
|
|
|
|
2.响应参数
|
|
|
|
|
|
-
|
|
|
-
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| -------- | ---------- | ---- | -------------- |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
-## 4.应答码
|
|
|
+## 4. 应答码
|
|
|
|
|
|
| 应答码 | 描 述 |
|
|
|
| ------ | ------------ |
|
|
|
@@ -139,7 +129,7 @@ signature: 16d93a9ac6ca89bfdefb018924f11965
|
|
|
| U9 | 系统错误 |
|
|
|
| P4 | 功能不支持 |
|
|
|
|
|
|
-## 5.技术支持
|
|
|
+## 5. 技术支持
|
|
|
|
|
|
如果您在调试时遇到问题，请与我们联系：support@allpayx.com
|
|
|
|
