Skip to main content

概览

Waffo Pancake 使用退款工单系统。买家通过 API 或客户门户申请退款,每次申请都会创建一个按照定义的生命周期流转的工单。商家在仪表盘中审核和处理工单。

业务规则

这些规则由 API 强制执行,无法覆盖。
  • 一次性产品在支付后 14 天内可申请退款。
  • 订阅不使用退款工单系统。取消在当前计费周期结束时生效。
  • 部分退款可通过在创建工单时提供自定义 amount(显示格式字符串,例如 “15.00”)来实现。

退款工单状态

每个退款工单按以下生命周期流转:

pending

已申请退款,等待审核。

approved

商家已批准退款。

rejected

退款申请被拒绝。

processing

退款正在由支付服务商处理。

succeeded

退款已成功完成。

failed

退款处理失败。

创建退款工单

通过 API Key 认证调用 API 来创建退款工单。

端点

认证方式: API Key

请求体

string
必填
要退款的支付 ID(UUID v4)。
string
必填
退款原因说明。
string
退款金额,以显示格式字符串表示(如 “15.00”)。省略则为全额退款。

响应

string
创建的退款工单唯一 ID。
string
工单的初始状态。创建时始终为 pending
string
退款金额,以显示格式字符串表示。

示例


查询退款工单

使用 GraphQL 检索退款工单数据。

Webhook 通知

您可以配置 Webhooks 在退款工单事件发生时接收通知。有关设置说明,请参阅 Webhooks 指南

减少退款请求

准确的描述能减少”与预期不符”的退款请求。
让客户先试后买,减少购买后的后悔。
快速解决问题,避免演变为退款请求。
使用清晰的账单描述,让客户能识别扣款来源。