Paydify Docs

提现回调通知

POST

{notificationEndpoint}

提现单到达终态时，Paydify 向应用 payout 配置的回调地址（notificationEndpoint，由 Paydify 为应用配置，非下单时传入）发起 POST 回调（Paydify → 商户）。仅推送终态（SUCCESS / FAILED），每笔提现仅推送一次；批量提现的每笔明细同样通过本回调逐笔通知，批次级状态请通过批量提现查询接口主动查询。回调报文携带 notifyType=withdraw（2026-09-15 起新增），与充值回调（notifyType=deposit）、CEX UID 转账回调（notifyType=uid_transfer）共用回调地址时可据此分派处理。商户必须验签后处理，并按 withdrawId + status 幂等去重；处理成功需应答 HTTP 200 + 裸字符串 success（不区分大小写），其它任何响应会按 15s / 45s / 90s / 180s / 10m / 30m / 60m / 3h / 6h / 12h 间隔重推，连同首推最多 11 次。代发订单（Partner 凭据创建）的回调签名使用下单凭据的 apiSecret，x-api-key 仍为订单归属应用的 appId。

请求

请求头参数

content-type

string

REQUIRED

固定值：application/json

x-api-key

string

REQUIRED

订单归属应用的 appId

x-api-timestamp

string

REQUIRED

时间戳，单位毫秒

x-api-signature

string

REQUIRED

签名，具体参看签名算法

请求体

appId

string

REQUIRED

订单归属应用的 appId

notifyType

string

REQUIRED

通知类型，固定值：withdraw。自 2026-09-15 起新增；此前的提现回调报文不含该字段，商户 JSON 解析需兼容新增字段（勿开启 FAIL_ON_UNKNOWN_PROPERTIES 之类拒绝未知字段的严格模式）

withdrawId

string

REQUIRED

Paydify 提现单号

mchWithdrawId

string

REQUIRED

商户提现单号（提现申请时传入的 mchWithdrawId）

status

string

REQUIRED

提现状态，回调仅推送终态：SUCCESS / FAILED

currency

string

REQUIRED

提现币种

network

string

REQUIRED

链网络（如 BSC/SOL/ETH/TRON/POLYGON）

amount

string

REQUIRED

提现金额，无值时为 0

gasFee

string

REQUIRED

链上 Gas 费，无值时为 0

processingFee

string

REQUIRED

处理手续费，无值时为 0

address

string

REQUIRED

提现目标地址

txnHash

string

链上交易 Hash，有值时返回

finishedTime

int

完成时间戳，单位毫秒，仅 SUCCESS 时返回；FAILED 无完成时间，不返回该字段

errorCode

string

失败错误码，仅 FAILED 时可能返回

errorMsg

string

失败原因说明，仅 FAILED 时可能返回

响应

响应体

string

REQUIRED

裸字符串 success（不区分大小写）。JSON 对象、HTML 错误页、空响应体或其它字面量（含 fail）都会被判定为失败并触发重推

示例报文

status=SUCCESS，notifyType=withdraw。txnHash 与 finishedTime 有值；amount 为提现金额，gasFee/processingFee 分别为链上 Gas 与处理手续费。

123456789101112131415
{
  "appId": "A14456006",
  "notifyType": "withdraw",
  "withdrawId": "W5081643613805694001",
  "mchWithdrawId": "MCH_WD_1757903025",
  "status": "SUCCESS",
  "currency": "USDT",
  "network": "BSC",
  "amount": "200",
  "gasFee": "0.0012",
  "processingFee": "1",
  "address": "0x5F2c1E9d8B7a6C5d4E3f2A1b0C9d8E7f6A5b4C3d",
  "txnHash": "0x3f9c1b3a7d4e5f60718293a4b5c6d7e8f9012a3b4c5d6e7f8091a2b3c4d5e6f7",
  "finishedTime": 1789439025000
}