提现申请
请求方式和路径
POST /payout/v1/withdraw/apply
请求头
| 字段名 | 类型 | 必传 | 描述 |
|---|
| content-type | string | 是 | application/json |
| x-api-key | string | 是 | Paydify提供，跟appId相同 |
| x-api-timestamp | string | 是 | 时间戳，单位毫秒 |
| x-api-signature | string | 是 | 签名，具体参看签名算法 |
请求体
| 字段名 | 类型 | 必传 | 描述 |
|---|
| mchWithdrawId | string | 是 | 商户侧订单号，唯一 |
| amount | string | 是 | 单笔提现金额，精度最大长度为 2 位 |
| currency | string | 是 | 提现币种，如USDT、USDC |
| network | string | 是 | 链信息，枚举值参看支持的链和币种 |
| address | string | 是 | 提现地址 |
| memo | string | 否 | 转账等备注信息 |
| merchantId | string | 否 | 提现单归属商户 ID（子商户）。合作伙伴（Partner）凭据代发时必填；商户自有凭据可不传，默认归属凭据所属商户。最长 64 字符 |
| merchantAppId | string | 否 | 归属商户下的应用 ID，用于归属商户存在多个已授权应用时消歧。凭据覆盖该商户多个应用时必填；仅一个授权应用时可不传，系统自动匹配。最长 64 字符 |
响应头参数
| 字段名 | 类型 | 必传 | 描述 |
|---|
| x-api-key | string | 是 | Paydify提供，跟appId相同 |
| x-api-timestamp | string | 是 | 时间戳，单位毫秒 |
| x-api-signature | string | 是 | 签名，具体参看签名算法 |
返回值
| 字段名 | 类型 | 描述 |
|---|
| code | string | 响应码，SYS_SUCCESS表示成功 |
| message | string | 响应消息 |
| messageDetail | string | 响应消息详情 |
| success | boolean | 是否成功 |
| data.withdrawTxnId | string | Paydify提现交易订单号 |
| data.mchWithdrawId | string | 商户侧付款单号 |
| data.state | string | 提现状态，初始为PENDING |
示例
# 请求
{
"mchWithdrawId": "MCH_WD_1756287002",
"amount": "100.00",
"currency": "USDT",
"network": "trx",
"address": "TXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"memo": "merchant withdraw"
}
# 成功返回值
{
"code": "SYS_SUCCESS",
"message": null,
"messageDetail": null,
"data": {
"withdrawTxnId": "W1167515578018041857",
"mchWithdrawId": "MCH_WD_1756287002",
"state": "PENDING"
},
"success": true
}
# 失败返回值
{
"code": "SYS_ERROR",
"message": "System error",
"messageDetail": "Error details",
"data": null,
"success": false
}
