← 全部教程

教程 10 / 10

为多位商家接收付款。

客户一次付款,商家余额分开记录,付款可控。

完成后您将拥有

三位商家共用结账,佣金 4%,付款策略经审核。

1. 准备项目

打开项目 → Marketplace → 设置,启用功能并选择店铺。暂时保持付款暂停。备份项目钱包,并在各店铺启用 Bitcoin 或受支持 EVM 方式。

客户先付给这些项目钱包。你控制私钥,并负有向商家支付账面余额的义务。另备可用原生币支付费用,普通归集不能使用 Marketplace 收款地址。

2. 添加并批准三位商家

在商家页添加每位卖家及 Bitcoin 主网地址。批准前通过独立渠道向卖家确认地址。使用 EVM 代币时,每位卖家还需在对应确切网络上有已批准地址。

项目佣金设为 4%。店铺、商家及已授权账单覆盖值会保存快照,之后修改不会改变现有份额。

3. 创建合并账单

在 Marketplace → 账单创建 300 USD 账单,三位商家毛额各 100 USD,合计须完全一致。将结账链接发给客户。

接入 API 时使用独立 Marketplace 密钥,将十进制字符串发送至 /v1/marketplace/invoices。请求前保存幂等键,超时后沿用同一键。 请求示例 →

4. 审核并发送

等待已验证份额可用。按锁定报价,每位卖家获得所付资产的 96 USD 等值,你保留 12 USD 等值佣金。若处理费配置为 1%,会扣 3 USD 预付余额。链上费用另计。

在付款页准备可用份额,设置原生费用与 gas 上限。Bitcoin 要求所选账单的全部未付份额在同一批次。检查准确收款人及计划,一次批准后跟踪至 Paid,而非仅 Broadcast。

5. 谨慎启用自动化

在设置中为资产新增策略:最低付款额、单次与每日本金限额、原生费用及 gas 预算、间隔和确认数。检查限额与地址后再启用,然后取消付款暂停。

自动策略无需再次点击即可转账。余额不足或服务器转账开关会暂停支出,监测与账本仍继续。

6. 处理异常,避免重复发送

  • 不足额:结账容差不会创造无资金支持的商家余额。等待补款、退款,或明确批准更小且有实际资金的分配。
  • 代币缺 gas:向项目钱包补充可用原生币并审核保留的付款,不要另建付款来绕过它。
  • Webhook 超时:重试同一签名事件。验证原文签名和项目,唯一保存 event_id 后确认。账单结清事件不代表商家付款完成。
  • 商家已收款后的退款:另行给主地址提供资金,核实客户地址,准备同资产全额退款并批准。不会自动扣商家的款。
  • 恢复备份或广播结果不确定:保持付款暂停,先核对保留的交易哈希再恢复。不能因超时就认定没有发送。

操作说明 · API、权限与事件