受理与处理退款
开放待确认
付款明细查询以及创建、查询、列出、取消退款的商户开放状态待确认。以下资金操作只适用于这些能力已在目标环境对账户开放的情况。尚未开放时可以登记售后、核对原订单并安排负责人跟进,不能向客户承诺平台已自动退款或固定到账天数。
退款针对实际付款项,不直接按业务订单金额退款。当前契约固定原网络、原稳定币和退款接收地址,商户不能改为客户在聊天中提供的其他地址。退款为直接 ERC-20 转账,不经过 IPP 隐私支付流程;商户另付 Gas,付款人收到完整退款金额。
先受理售后
- 记录订单、Checkout、退款原因和客户诉求,核对是否已交付及是否已有退款申请。
- 将取消服务、撤销权益、账务调整和退回资金分别处理;取消订单不等于钱已退回。
- 确认付款明细和退款链路均已开放;不具备条件时保留“待核对/待处理”,通过已核实渠道沟通后续安排。
已开通后的操作
- 查询原 Checkout 的付款项,定位
attempt_id。只有 finalized 到账计入可退计算;Checkout 成功不自动代表资金已可退。 - 核对当前
amount_refundable,它已扣除成功退款和进行中占用。部分退款用约定数额,退清用当前剩余额度;不同付款项分别处理。 - 再次查询是否有进行中退款。同一 Payment Intent 下最多一笔
requires_action或processing退款,换付款项也不能绕过。 - 由有权限人员批准金额和原因,技术人员持久化售后单、参数及本次幂等键后创建退款。保存返回的 Refund ID,不将创建成功记为已退款。
- 按返回的真实
next_action.url打开签名页面,核对原付款关联与金额,再由商户钱包操作。不要自行拼接页面或索要客户私钥。 - 查询原退款任务直到有明确结果,再更新售后记录并通知客户。
金额须为精确十进制,满足原资产精度及转账范围,通用上限 8 位小数;不使用浮点数或自动按两位小数四舍五入。
根据结果继续
| 结果 | 操作 |
|---|---|
requires_action | 等待钱包操作;若之前已发送交易,先核查原执行,避免重复转账 |
processing | 等待平台核实;不重发,也不能取消 |
succeeded | 转账已 finalized,记录完成与已退金额 |
canceled | 额度占用已释放,不再执行这笔 Refund |
| 超时、拒签、页面关闭 | 不代表退款完成;查询原任务,保留原操作关联 |
已确定的执行失败通过 last_execution_error 报告,不是独立的退款 failed 状态。只有平台确认旧执行失败、没有其他未知执行且返回 requires_action,才在同一 Refund 内重试签名;失败处理期间额度继续占用。
仅 requires_action 可申请取消,且系统确认原退款已取消后才成立;取消与签名可能竞争,不能仅凭点击取消就重新退款。结果未知时用原操作恢复,不能另换幂等键再次退钱。
常见问题
可退额度不足先检查未完成占用和已退金额;高 Gas 或钱包余额不足先解决执行条件,不擅自扣减客户退款。客户要求换链、换币或换地址时,本流程不支持直接修改。多付、迟到款的识别见资金异常,完成后按费用指南对账。