1. 分销模块API
API URL
post {HTTP(S)地址}/api/{version}/distribution
1.1. 分销商充值接口
1.1.1. SERVICE_TYPE
DISTRIBUTION_RECHARGE_REFUND
1.1.2. 请求参数
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| distributorCustomerName | Y | String | "QY12345" | 分销商用户账号 |
| distributorEnv | Y | String | "DOMESTIC" | 分销商环境 DOMESTIC：国内； CROSSBORDER：海外 |
| type | Y | String | "RECHARGE" | 交易类型： RECHARGE：充值； REFUND：退款 |
| payChannel | N | String | "ALIPAY" | 支付方式： ALIPAY：支付宝； BANK_TRANSFER：银行转账； CASH：现金； WECHAT_PAY：微信 |
| distributorAccount | N | String | 分销商充值账号 | |
| transactionCompleteTime | N | String | "2024-05-20 15:40:30+08:00" | 交易完成时间（充值/退款时间） |
| totalPrice | Y | Decimal | 100 | 交易金额，正数 |
| supplierAccount | N | String | 我方收款账号 | |
| remark | N | String | "备注" | 备注 |
1.1.3. 返回参数
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| errorCode | Y | String | “DATA_INPUT_ERROR” | 错误码 |
| errorMsg | Y | String | “输入参数不对” | 业务错误信息 |
| state | Y | String | success | 请求结果 |
请求示例:
curl --location --request POST 'https://gerp-test1.800best.com/api/v1/distribution' \
--form 'appId="TEST"' \
--form 'serviceType="DISTRIBUTION_RECHARGE_REFUND"' \
--form 'bizParam="{
\"distributorCustomerName\": \"QY123456\",
\"distributorEnv\": \"DOMESTIC\",
\"type\": \"RECHARGE\",
\"payChannel\": \"ALIPAY\",
\"distributorAccount\": \"distributorAccount\",
\"transactionCompleteTime\": \"2026-07-17 10:00:00\",
\"totalPrice\": 10,
\"supplierAccount\": \"supplierAccount\",
\"remark\": \"remark\"
}"' \
--form 'timestamp="1731742317"' \
--form 'sign="39c2cacfe7a6afb55e2cc62ee5a8d738"'
返回示例:
{
"state": "success",
"errorCode": "",
"errorMsg": "",
"bizContent": "{\"notSuccess\":false,\"state\":\"success\",\"traceId\":\"4c4fede89f504d6b986df52fbd034da0\"}",
"requestId": "cdeac7da-54c8-4939-998e-c8316e82b196"
}