概览
Waffo Pancake 使用退款工单系统。买家通过 API 或客户门户申请退款,每次申请都会创建一个按照定义的生命周期流转的工单。商家在仪表盘中审核和处理工单。业务规则
这些规则由 API 强制执行,无法覆盖。
- 一次性产品在支付后 14 天内可申请退款。
- 订阅不使用退款工单系统。取消在当前计费周期结束时生效。
- 部分退款可通过在创建工单时提供自定义
amount(显示格式字符串,例如 “15.00”)来实现。
退款工单状态
每个退款工单按以下生命周期流转:pending
已申请退款,等待审核。
approved
商家已批准退款。
rejected
退款申请被拒绝。
processing
退款正在由支付服务商处理。
succeeded
退款已成功完成。
failed
退款处理失败。
退款到账时效与「处理中」的含义。 银行卡退款由发卡行受理,通常 3–10 个工作日内到账,最长不超过 14 个工作日;微信支付退款即时到账。工单处于
processing(处理中 / 审核中)表示已进入支付通道和银行受理阶段,平台不会在此之上再做内部财务审核。创建退款工单
通过 API Key 认证调用 API 来创建退款工单。端点
请求体
string
必填
要退款的支付 ID(UUID v4)。
string
必填
退款原因说明。
string
退款金额,以显示格式字符串表示(如 “15.00”)。省略则为全额退款。
响应
string
创建的退款工单唯一 ID。
string
工单的初始状态。创建时始终为
pending。string
退款金额,以显示格式字符串表示。
示例
cURL 标签页使用 API Key 鉴权 —— 三个签名请求头,不是 Bearer token。X-Signature 的计算方法见 API Key 认证,或直接用 SDK 由它代签。
查询退款工单
使用 GraphQL 检索退款工单数据。Webhook 通知
您可以配置 Webhooks 在退款工单事件发生时接收通知。有关设置说明,请参阅 Webhooks 指南。减少退款请求
清晰的产品描述
清晰的产品描述
准确的描述能减少”与预期不符”的退款请求。
提供试用期
提供试用期
让客户先试后买,减少购买后的后悔。
及时响应支持
及时响应支持
快速解决问题,避免演变为退款请求。
可识别的账单描述
可识别的账单描述
使用清晰的账单描述,让客户能识别扣款来源。