# 文档说明
## 一、登录商户后台
* 联系运营获取 **商户后台链接**、**登录账号** 和 **密码**（仅供测试使用）。
* 登录后，点击右上角 **「API接口设置」**。
## 二、设置AccessKey
* 点击 **重新生成 AccessKey**。
* 填写谷歌验证码
* 点击 **提交** 后生效。
⚠️ **注意事项：**
* 如果有填写回调地址，提交时，系统会POST回调地址，发送内容为文本“Test”，回调响应HTTP状态必须为200，否则提交失败！
## 三、接口调用说明
### V1
* 请求时，在 **Header** 中设置：
```
Content-Type: application/json
Authorization: {AccessKey}
```
* 示例：
```
Content-Type: application/json
Authorization: ecb797f9e9feab0a92ab283978d33711
```
### V2
* 请求时，在 **Header** 中设置：
```
Content-Type: application/json
Authorization: {商户ID}
```
* 示例：
```
Content-Type: application/json
Authorization: 1514639549140992
```
## 四、回调说明
* 只有成功的订单才会触发回调。
* 回调地址可以在拉单的时候单独设置，如果拉单的时候没有设置，会使用后台设置的回调地址进行回调。
* 回调IP来自：65.20.91.228
* 回调失败会自动重试3次。
* 回调请求方式：**POST**。
* 回调内容：**AES 加密的 JSON 字符串**。
**示例：渠道代收回调**
```
{
"sourceNo": "商户订单号"
"data": "加密后的代收订单详情(具体参数参考get返回值)字符串"
}
```
**示例：解密后的代收订单详情(具体参数参考get返回值)**
```
{
"channelCreditOrderSimpleInfo": {
"id": 1,
"merchantId": 1,
"merchantSourceNo": "text",
"fiatAmount": 1,
"tokenAmount": 1,
"processCode": 0,
"createdTime": 1,
"updatedTime": 1,
"cashierLink": "text",
"payerAccountDetailList": [
{
"accountName": "text",
"bankNo": "text",
"bankAccount": "text"
}
],
"payeeAccountDetail": {
"accountName": "text",
"bankNo": "text",
"bankAccount": "text"
},
"paid": true,
"callbackCode": 0,
"closedTime": 1
}
}
```
## 五、AES 加密说明
* 运算模式：**ECB**
* 填充模式：**PKCS7**
* 秘钥长度：**256 bits**
* 秘钥：同 **AccessKey**
* 字符编码：**UTF-8**
* 输出格式：**Base64**
🔑 **示例**
* 原始值：`Test`
* 秘钥：`ecb797f9e9feab0a92ab283978d33711`
* 加密结果：`M2SwiX1fxQ5aJ34scDi0zA==`
👉 在线测试工具：[AES 加密工具](https://www.toolhelper.cn/SymmetricEncryption/AES)
## **六、接口文档与环境说明**
* **测试环境 Endpoint**：
* **生产环境 Endpoint**：
⚠️ 在正式上线前，请务必联系运营人员获取 **生产环境商户后台链接**，并完成以下事项：
1. 重新申请并配置 **AccessKey**；
2. 设置并验证 **回调地址**（代收、代付）；
3. 确认回调接口能正常响应200(OK)状态。
以上配置完成并通过测试后，方可切换至生产环境进行业务操作。