主题
商户提现申请
接口描述
- 接入方可以通过该接口进行商户主动提现，提现结果异步通知返回，如未收到异步通知返回，可通过提现查询接口查询提现状态。
请求URL
/merchant/settleApply
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS241111000102 |
| accountType | 是 | string | 32 | 账户类型： BASE-基本户; SETTLEMENT-结算账户 | SETTLEMENT |
| requestNo | 是 | string | 32 | 请求流水号 | 123456789 |
| settleAmount | 是 | number | 20 | 提现金额(单位分) | 100 |
| remark | 否 | string | 50 | 备注 | 提现 |
| notifyUrl | 否 | string | 255 | 提现回调通知地址 | https://aaa.bbb.ccc/notify |
| accountBankCode | 否 | string | 32 | 银行编码(银行账户必填,SMBYY:苏商银行) | SMBYY |
请求报文示例
json
{
"appId": "202415629590370906",
"merchantNo": "XS241111000102",
"accountType": "SETTLEMENT",
"requestNo": "18595450000003001",
"settleAmount": 1,
"signature": "UA1MOjpmc/XCHT7v7FwtisdzBEMdWDcXs+GcWK5n0wd3vhcpFJgLo0A/KfS/LQRmq4Cm2kHSJ8J6GNml0Qxn6JtXmEoJVTQDnIrHvy/0Z/a/+OEyFMhaqVkV+fD7+3hsd8QFaJ/9+C3+95dtbF5bNIxU1lYdq3aYmzyrprfskwFjFy8R1P0VdIbmupQZo1MaZTl7ck4IZf0jcz36kJmzjFQaa5dCfHxWkYJxRx+8LjBCRR+bk0aiRMFTIoT22QA6Bq9xAj09cG7BkQXrTQQvwPNke+AtWS4aPnqJbp358eRljZFaLNqAFP2d2Kd0ebIEtWjdgoPz+ZX5nZ269ed1xg==",
"transDate": "1731470119410",
"transNonce": "ac12c789-6d3b-43df-93f5-54d23eb1b30e"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| drawNo | 是 | string | 32 | 提现流水号 | 1856546347350794241 |
响应示例
json
{
"code": "00000000",
"drawNo": "1856546347350794241",
"message": "成功",
"signature": "UA1MOjpmc/XCHT7v7FwtisdzBEMdWDcXs+GcWK5n0wd3vhcpFJgLo0A/KfS/LQRmq4Cm2kHSJ8J6GNml0Qxn6JtXmEoJVTQDnIrHvy/0Z/a/+OEyFMhaqVkV+fD7+3hsd8QFaJ/9+C3+95dtbF5bNIxU1lYdq3aYmzyrprfskwFjFy8R1P0VdIbmupQZo1MaZTl7ck4IZf0jcz36kJmzjFQaa5dCfHxWkYJxRx+8LjBCRR+bk0aiRMFTIoT22QA6Bq9xAj09cG7BkQXrTQQvwPNke+AtWS4aPnqJbp358eRljZFaLNqAFP2d2Kd0ebIEtWjdgoPz+ZX5nZ269ed1xg==",
"transDate": "1731470119410",
"transNonce": "ac12c789-6d3b-43df-93f5-54d23eb1b30e"
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述