法币提现回调通知
{callbackUrl}
法币提现单到达终态（COMPLETED / FAILED / CANCELLED / REJECTED）时，Paydify 向法币提现应用配置的回调地址（由 Paydify 为应用配置，非下单时传入）发起 POST 回调（Paydify → 商户）。非终态（PENDING / PROCESSING / SETTLING 等）不推送，每笔提现仅推送一次。回调报文携带 notifyType=withdraw（2026-09-15 起新增）。商户必须验签后处理，并按 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（与加密货币提现回调取值相同；法币提现回调推送到法币提现应用单独配置的回调地址，可按 currency=USD 或回调地址区分）。自 2026-09-15 起新增；此前报文不含该字段，商户 JSON 解析需兼容新增字段
withdrawId
string
REQUIRED
Paydify 法币提现单号
txnId
string
REQUIRED
同 withdrawId，取值相同
mchWithdrawId
string
REQUIRED
商户订单号（发起提现时传入的 mchOrderId）
status
string
REQUIRED
提现状态，回调仅推送终态：COMPLETED / FAILED / CANCELLED / REJECTED
currency
string
REQUIRED
币种，当前固定 USD
orderCurrency
string
REQUIRED
到账币种，当前固定 USD
settlementCurrency
string
REQUIRED
结算币种，当前固定 USD
orderAmount
string
到账金额（USD），有值时返回
settlementAmount
string
到账金额（USD），与 orderAmount 取值相同
amount
string
REQUIRED
实际扣减总额（USD），无值时为 0
withdrawFeeAmount
string
提现手续费（USD），有值时返回
processingFee
string
REQUIRED
提现手续费（USD），与 withdrawFeeAmount 同源，无值时为 0
gasFee
string
REQUIRED
法币提现场景固定为 0
finishedTime
int
完成时间戳，单位毫秒，有值时返回（通常仅 COMPLETED）；未结算的终态不返回该字段
quoteId
string
报价会话 ID，有值时返回
deductionSnapshot
string
扣减计划快照，JSON 字符串
bankAccountSnapshot
string
收款银行账户快照，JSON 字符串
errorMsg
string
失败/拒绝原因，仅 FAILED / REJECTED 时可能返回
响应
响应体
响应体
string
REQUIRED
裸字符串 success（不区分大小写）。JSON 对象、HTML 错误页、空响应体或其它字面量（含 fail）都会被判定为失败并触发重推
示例报文
status=COMPLETED，notifyType=withdraw。orderAmount/settlementAmount 为到账 USD 金额（2 位小数），amount 为实际扣减总额（含手续费），gasFee 固定 0。deductionSnapshot / bankAccountSnapshot 为 JSON 字符串，示例中省略。
12345678910111213141516171819{"appId": "A14456006","notifyType": "withdraw","withdrawId": "W5081643613805694601","txnId": "W5081643613805694601","mchWithdrawId": "FIAT_WD_20260915_001","status": "COMPLETED","currency": "USD","orderCurrency": "USD","settlementCurrency": "USD","orderAmount": "1000.00","settlementAmount": "1000.00","amount": "1015","withdrawFeeAmount": "15.00","processingFee": "15","gasFee": "0","finishedTime": 1789439025000,"quoteId": "FQ5081643613805690001"}