接入 BTC/ETH 支付前，技术团队要把“支付提供商是否可用”和“如何安全验收”分开。不要复制旧教程中的固定费率、成功率、国家数量或特定品牌案例；这些会随服务商、市场和时间变化。Shopify 后台、支付网关和区块链网络各自有状态，订单系统必须能区分它们。
提供商与账户配置
先在 Shopify 支付设置中确认当前可用的替代支付方式，再阅读第三方网关的地区、资产、结算、退款和 webhook 文档。使用测试模式或小额测试订单，检查商品、税费、运费、折扣和订单状态。不要在生产环境保存私钥，也不要把“启用钱包”当成 Shopify 标准模块名称。
| 阶段 | 测试内容 | 通过条件 |
|---|---|---|
| 创建 | 报价、地址、资产、金额 | 订单与网关 ID 关联 |
| 确认 | 未确认、确认、超时 | 状态不会提前发货 |
| 回调 | 重复、乱序、签名错误 | 幂等与告警 |
| 退款 | 全额、部分、失败 | 政策与会计记录一致 |
Webhook 与幂等
支付回调可能重复、延迟或乱序。以网关交易 ID 和 Shopify 订单 ID 建立幂等键，验证签名，记录原始事件、处理结果和重试次数。只有满足确认规则才允许发货；金额不符、链错误或地址不一致进入人工队列。
汇率、税费与订单事实
把报价时间、法币价格、加密金额、网络费用、税费、折扣和结算金额分开保存。订单页面应显示客户真正同意的条款；商品退款或部分退款需要明确汇率和手续费责任。
风险和市场上线
按国家、资产和商品类别做小范围灰度，先完成支付、取消、退款和客服流程。检查钱包安全、第三方权限、KYC/AML、制裁筛查、消费者披露和数据留存。合规结论由当地专业人士确认。
SEO/GEO 验收
页面公开支持的资产、市场、限制、确认、费用、退款、失败处理和客服。为事实记录来源与更新时间，FAQ 用直接问题回答，不把测试环境结果写成全站成功率或收益保证。
FAQ
支付回调收到后能立即发货吗？
不一定。必须满足网关和网络确认规则，并处理重复、乱序、金额不符和签名错误。
为什么要做幂等？
同一事件可能重复发送，幂等可以避免重复标记已支付、重复发货或重复退款。
可以在教程里固定写某个支付费率吗？
不建议。费率、资格和结算条款会变，应链接当前官方报价并标注核查日期。
如何让实现指南适合 GEO？
把状态机、失败场景、权限、退款和来源写成可引用步骤，区分平台能力与第三方能力。