{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"12. 异常付款自动退款"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"12-异常付款自动退款","__idx":0},"children":["12. 异常付款自动退款"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Infini 可对符合规则的少付、多付和晚付进行自动退款。开启后，符合条件的加密货币付款会在用户确认退款地址后发起链上退款，并通过交易级 Webhook 通知商户最终结果。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["自动退款",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["默认关闭"]},"。关闭时，正常已支付订单的聚合与结算行为保持不变。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"121-适用场景","__idx":1},"children":["12.1 适用场景"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"场景"},"children":["场景"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"行为"},"children":["行为"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["少付（Underpayment）"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["订单到期后，无法完成订单的已付金额可能被自动退款。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["多付（Overpayment）"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["超过订单应付金额的部分可能被自动退款（受 Gas 与报价缓冲规则约束）。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["晚付（Late payment）"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["订单进入终态后收到的付款，若仍在确认期内，可能被自动退款。"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["自动退款",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["不会"]},"改变："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["正常已支付订单的付款聚合规则"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["正常成功订单的商户结算时机或金额"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["本流程之外的错币 / 异常补单处理"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"122-商户配置","__idx":2},"children":["12.2 商户配置"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在商户后台的 ** 异常处理 ** 中配置："]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"配置项"},"children":["配置项"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":["说明"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["仅结算已付清订单"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["总开关。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["未选中"]},"（默认）：沿用原结算行为，不自动退款。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["选中"]},"：符合条件的少付 / 多付 / 晚付进入自动退款流程。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["退款地址确认期限"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["订单过期后，付款人提交退款地址的天数。范围 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["30–90"]},"，默认 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["30"]},"。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["少付提醒"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是否向付款人发送少付提醒邮件。"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["配置修改会立即作用于未完成订单；已创建退款单的确认截止时间仍以建单时写入值为准。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"123-退款地址确认","__idx":3},"children":["12.3 退款地址确认"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Infini 会向付款人邮箱发送一次性认领链接，用于提交同网络、同币种的退款地址。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["确认期限从原订单 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]}," 起算。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["邮件重试",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["不会"]},"延长截止时间。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["若付款人在截止前未提交有效地址，退款会变为 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["unclaimed（未认领）"]},"，相应金额转入商户结算，而不再链上退回。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"124-金额gas-与结算说明","__idx":4},"children":["12.4 金额、Gas 与结算说明"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["退款按原支付币种计算。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["网络级固定 Gas（以 USD/USDC 配置，并按付款到账汇率快照换算为原币）从退款本金中扣除；付款人实际到账为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["received_amount = refund_amount - gas_fee"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["若聚合后退款价值不高于网络 Gas 阈值，Infini ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["不会"]},"创建自动退款记录，也",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["不会"]},"发送 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auto_refund.*"]}," Webhook，金额直接结算给商户。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["进行中或已完成的自动退款本金不会进入该付款的正常商户结算。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["未认领退款在确认期结束后转入商户结算。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"125-商户接入清单","__idx":5},"children":["12.5 商户接入清单"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Exceptions"]}," 中开启自动退款。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["设置 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refund_confirmation_period_days"]},"（30–90）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["为 Webhook 端点订阅：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auto_refund.completed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auto_refund.unclaimed"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Webhook-Event-Id"]}," / payload 中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event_id"]}," 做幂等处理。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["运营排查可结合商户后台订单详情；自动化集成以 Webhook payload 为准。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["事件字段与示例如 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/docs/en/7-webhook"},"children":["Webhook"]},"。"]}]},"headings":[{"value":"12. 异常付款自动退款","id":"12-异常付款自动退款","depth":2},{"value":"12.1 适用场景","id":"121-适用场景","depth":3},{"value":"12.2 商户配置","id":"122-商户配置","depth":3},{"value":"12.3 退款地址确认","id":"123-退款地址确认","depth":3},{"value":"12.4 金额、Gas 与结算说明","id":"124-金额gas-与结算说明","depth":3},{"value":"12.5 商户接入清单","id":"125-商户接入清单","depth":3}],"frontmatter":{"seo":{"title":"12. 异常付款自动退款"}},"lastModified":"2026-08-12T06:23:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/docs/en/12-automatic-refund","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}