W Checkout
  1. 快速开始
W Checkout
  • 概览
  • 集成准备
  • 快速开始
    • 集成订单支付
    • 退款
    • 结算
    • Webhook
    • 枚举对照表
  • 接口目录
    • 鉴权
      • 获取AccessToken
    • 支付订单
      • CreateCheckoutOrder
      • CancelCheckoutOrder
      • GetCheckoutOrderInfo
      • GetCheckoutOrderList
    • 退款单
      • CreateRefundOrder
      • CancelRefundOrder
      • GetRefundOrderInfo
      • GetRefundOrderList
    • 结算单
      • CreateSettlementOrder
      • CreateFiatSettlementOrder
      • CancelSettlementOrder
      • GetSettlementOrder
      • GetSettlementOrderList
    • 异常支付
      • GetAbnormalPaymentList
      • CreateAbnormalPaymentRefund
    • Webhook
      • WcheckoutWebhook
  1. 快速开始

退款

本文介绍 W Checkout 的支付用户退款流程。

退款场景#

用户发起退款:用户在正常支付订单后,主动申请退款。
用户多付:用户在钱包中支付的金额超出了订单金额。
用户少付:直到订单超时后,用户仅支付了部分金额。

处理流程#

1. 获取异常支付场景#

针对 多付、少付、晚付 等异常支付场景,开发者可通过以下方式获取信息:
Webhook:订阅消息推送,系统将推送异常支付事件。
接口查询:调用 getAbnormalPayments 主动查询异常支付订单。

2. 发起退款#

调用 createOrderRefund 接口发起退款,代币会按照订单的支付地址 原路退回 指定金额。

请求参数#

参数名类型必填说明
refundOrderNoString是客户系统生成的唯一退款单号,用于标识本次退款。
orderNoString是关联的支付订单编号,用于订单退款。
abnormalPaymentNoString是关联的异常支付编号,用于异常支付退款。
amountNumber是本次需要退款的金额。

3. 获取退款单状态#

您可通过以下方式获取退款进度和结果:
Webhook 通知
订阅退款相关事件,系统将在退款状态变更时推送通知。
接口查询
调用 getOrderInfo 接口查询支付订单及其退款状态。

开发者注意事项#

原路退回:退款代币将退至用户支付时使用的钱包地址。
幂等性:建议退款接口调用时使用唯一的 refundOrderNo,避免重复退款。
异常对账:对于多付或少付场景,建议通过 getAbnormalPayments 定期对账。
修改于 2025-10-08 02:40:03
上一页
集成订单支付
下一页
结算
Built with