商户管理服务
接口列表
提现结果通知

提现结果通知

当提现状态发生变更时,通知上游业务方。通知URL在提现接口处指定。 注意:只通知成功、失败、退票的情况。

接口说明

请求方式:
post
接入方提供回调地址 URL

请求参数

Request
Body 包体
OutWithdrawId必填
string

外部提现单号


WithdrawStatus必填
string

提现状态.SUCCESS:提现成功;FAILED:提现失败;


FailReason选填
string

失败原因


SettleAmount必填
integer

结算金额,单位:分


FeeAmount选填
integer

手续费金额,单位:分


WithDrawTime选填
string

提现交易时间。RFC3339格式,提现成功时值有效。本值并非提现到账时间,当前平安、中信、连连通道此字段有值

请求示例

{
  "OutWithdrawId": "20240814026",
  "WithdrawStatus": "SUCCESS",
  "FailReason": "",
  "SettleAmount": 1,
  "FeeAmount": 0,
  "WithDrawTime": "2025-05-08T15:57:28+08:00"
}

返回数据

上游业务方处理完成回调通知后,应以HTTP 200状态码返回处理结果 通知策略:如果接入方收到腾讯云商付平台的通知后,响应的HTTP状态码不为200,腾讯云商付平台认为通知失败。 并需要通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功(通知频率为5/5/10/30/60/60/60/60/60/60,单位:秒)。


腾讯云商付接口文档