Files
shaguabijia-app-server/docs/api/wallet/wallet-withdraw-status.md
guke a563c1ca4b @ (#111)
docs/api目录文档分类和补全

---------

Co-authored-by: guke <guke@autohome.com.cn>
Reviewed-on: #111
2026-07-03 15:00:37 +08:00

1.0 KiB
Raw Permalink Blame History

GET /api/v1/wallet/withdraw/status — 查提现单状态(轮询)

所属:Wallet 组(前缀 /api/v1/wallet | 鉴权:Bearer | ← 返回 API 索引

集成实现:见 integrations/wxpay(查单 / 撤销转账)。

入参(query

字段 类型 必填 说明
out_bill_no string 商户提现单号(withdraw 返回的)

出参

响应 200:WithdrawStatusOut

字段 类型 说明
out_bill_no string 商户提现单号
status string pending / success / failed
wechat_state string | null 微信侧原始状态
amount_cents int 提现额(分)

错误码

  • 404 提现单不存在(或不属于当前用户)

说明

App 从微信确认页返回后调此接口刷新单状态。副作用:若查时仍是 WAIT_USER_CONFIRM(用户在确认页放弃),后端会撤销该单并退回余额(cancel_if_unconfirmed=True)。