|
@@ -55,10 +55,10 @@ signature: 25f4eb90cebec86cf0467659f466e345
|
|
|
```
|
|
```
|
|
|
### 2.3 通用说明
|
|
### 2.3 通用说明
|
|
|
|
|
|
|
|
- **请求方式：** `POST`
|
|
|
|
|
- **数据格式：**`JSON`
|
|
|
|
|
- **测试主机：**`https://testapi.allpayx.com`
|
|
|
|
|
- **生产主机：** `https://api.allpayx.com`
|
|
|
|
|
|
|
+ **请求方式：** `POST`<br>
|
|
|
|
|
+ **数据格式：**`JSON`<br>
|
|
|
|
|
+ **测试主机：**`https://testapi.allpayx.com`<br>
|
|
|
|
|
+ **生产主机：** `https://api.allpayx.com`<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3. 线上支付API
|
|
## 3. 线上支付API
|
|
@@ -71,29 +71,31 @@ signature: 25f4eb90cebec86cf0467659f466e345
|
|
|
`/api/createcashier`
|
|
`/api/createcashier`
|
|
|
|
|
|
|
|
**3. 请求参数**
|
|
**3. 请求参数**
|
|
|
-| 参数 | 类型 | 必填 | 描述
|
|
|
|
|
-|------------- | ------------ | ---- | -------
|
|
|
|
|
-| paymentSchema | String(10) | 是 | FC
|
|
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+| 参数 | 类型 | 必填 | 描述 |
|
|
|
|
|
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
|
|
+| paymentSchema | String(10) | 是 | FC |
|
|
|
| version | String(12) | 是 | 统一填写为“VER000000005”
|
|
| version | String(12) | 是 | 统一填写为“VER000000005”
|
|
|
| charSet | String(6) | 是 | 统一填写为“UTF-8”
|
|
| charSet | String(6) | 是 | 统一填写为“UTF-8”
|
|
|
| transType | String(10) | 是 | 消费交易填写“PURC”
|
|
| transType | String(10) | 是 | 消费交易填写“PURC”
|
|
|
-| orderNum | String(60) | 是 | 订单号：商户自行定义，需保证同一商户号下订单号<br>不能重复
|
|
|
|
|
|
|
+| orderNum | String(60) | 是 | 订单号：商户自行定义，需保证同一商户号下订单号不能重复
|
|
|
| orderAmount | String(12) | 是 | 订单金额：如 100 元，表示为 100 或 100.00
|
|
| orderAmount | String(12) | 是 | 订单金额：如 100 元，表示为 100 或 100.00
|
|
|
-| orderCurrency | String(3) | 是 | 订单币种：ISO标准。如：人民币填写“CNY”，美元<br>填写"USD"
|
|
|
|
|
|
|
+| orderCurrency | String(3) | 是 | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"
|
|
|
| frontURL | String(400) | 是 | 支付完成后前端跳转到该URL
|
|
| frontURL | String(400) | 是 | 支付完成后前端跳转到该URL
|
|
|
-| backURL | String(400) | 是 | 支付结果异步通知到该URL。支付成功后，GoAllPay<br> 会以 POST 方式调用 backURL 通知支付结果（详见<br>回调参数）。商户在接收到通知后，需响应字符串<br>“OK”。 如果没有收到商户响应“OK”，GoAllPay将<br>会过一段时间后重新推送，时间间隔为[15, 15, 30, 180<br>, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
|
|
|
|
+| backURL | String(400) | 是 | 支付结果异步通知到该URL。支付成功后，GoAllPay 会以 POST 方式调用 backURL 通知支付结果（详见回调参数）。商户在接收到通知后，需响应字符串“OK”。 如果没有收到商户响应“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
| merID | String(15) | 是 | 商户 ID，由 GoAllPay 分配
|
|
| merID | String(15) | 是 | 商户 ID，由 GoAllPay 分配
|
|
|
| acqID | String(11) | 是 | 收单行 ID，统一填写为"99020344"
|
|
| acqID | String(11) | 是 | 收单行 ID，统一填写为"99020344"
|
|
|
| goodsInfo | String(60) | 是 | 商品信息。注意不要包含特殊符号，如 "#"，"&"，"+" 等
|
|
| goodsInfo | String(60) | 是 | 商品信息。注意不要包含特殊符号，如 "#"，"&"，"+" 等
|
|
|
-| detailInfo | String(400) | 是 | 商品明细。格式：`[{"goods_name":"iPhone X",`<br>`"quantity":"2"},{"goods_name":"iPhone 8",`<br>`"quantity":"4"}]`<br>，需Base64编码后上送。注意goods_name不要包含特殊符号，如 "#"，"&"，"+" 等
|
|
|
|
|
|
|
+| detailInfo | String(400) | 是 | 商品明细。格式：`[{"goods_name":"iPhone X",``"quantity":"2"},{"goods_name":"iPhone 8",``"quantity":"4"}]`，需Base64编码后上送。注意goods_name不要包含特殊符号，如 "#"，"&"，"+" 等
|
|
|
| transTime | String(14) | 是 | 交易时间，格式："yyyyMMddHHmmss"
|
|
| transTime | String(14) | 是 | 交易时间，格式："yyyyMMddHHmmss"
|
|
|
-| merReserve | String(1024) | 否 | 预留内容，商户自定义。注意不要包含特殊符号，<br>如 "#"，"&"，"+" 等
|
|
|
|
|
|
|
+| merReserve | String(1024) | 否 | 预留内容，商户自定义。注意不要包含特殊符号，如 "#"，"&"，"+" 等
|
|
|
| signType | String(10) | 是 | MD5或SHA256
|
|
| signType | String(10) | 是 | MD5或SHA256
|
|
|
| signature | String(32) | 是 | 采用 MD5或SHA256 签名
|
|
| signature | String(32) | 是 | 采用 MD5或SHA256 签名
|
|
|
-| OsType | String(20) | 是 | 操作系统类型。"IOS"，"ANDROID"，"HARMONYOS"，<br>"WINDOWS"，"MAC"，"OTHER" 选其中一个上送
|
|
|
|
|
|
|
+| OsType | String(20) | 是 | 操作系统类型。"IOS"，"ANDROID"，"HARMONYOS"，"WINDOWS"，"MAC"，"OTHER" 选其中一个上送
|
|
|
| OsVersion | String(20) | 否 | 操作系统版本。示例："10.0.19043"
|
|
| OsVersion | String(20) | 否 | 操作系统版本。示例："10.0.19043"
|
|
|
-| tokenFlag | String(10) | 否 | 是否同时返回订阅支付token的标识，<br>需要返回时，填写："True"，该功能需要单独审批开通。
|
|
|
|
|
-| tokenBackURL | String(400) | 否 | 订阅支付token的异步通知URL,当tokenFlag<br>为"True"时，必须填写
|
|
|
|
|
|
|
+| tokenFlag | String(10) | 否 | 是否同时返回订阅支付token的标识，需要返回时，填写："True"，该功能需要单独审批开通。
|
|
|
|
|
+| tokenBackURL | String(400) | 否 | 订阅支付token的异步通知URL,当tokenFlag为"True"时，必须填写
|
|
|
| logisticsCountry | String | 是 | 物流国家/地区，2位国家码，如：US
|
|
| logisticsCountry | String | 是 | 物流国家/地区，2位国家码，如：US
|
|
|
| logisticsState | String | 是 | 物流州/省/邦，2位编码，如：CA
|
|
| logisticsState | String | 是 | 物流州/省/邦，2位编码，如：CA
|
|
|
| logisticsCity | String | 是 | 物流城市
|
|
| logisticsCity | String | 是 | 物流城市
|
|
@@ -101,6 +103,7 @@ signature: 25f4eb90cebec86cf0467659f466e345
|
|
|
| logisticsPostalCode | String | 是 | 物流邮编
|
|
| logisticsPostalCode | String | 是 | 物流邮编
|
|
|
| logisticsEmail | String | 是 | 物流邮箱
|
|
| logisticsEmail | String | 是 | 物流邮箱
|
|
|
| logisticsPhone | String | 是 | 物流电话
|
|
| logisticsPhone | String | 是 | 物流电话
|
|
|
|
|
+
|
|
|
|
|
|
|
|
**4. 响应参数**
|
|
**4. 响应参数**
|
|
|
|
|
|
