<!-- Source: https://docs.infraio.xyz/zh-CN/get-started/migrate-from-coinbase-commerce -->
<!-- Last updated: 2026-10-04 -->

# 从 Coinbase Commerce 迁移

Coinbase Commerce 已于 **2026 年 3 月 31 日**终止美国和新加坡以外地区的自托管收银台。
如果你受到影响,InfraIO Pay 是一个非托管的替代方案:资金直接进入你自己的资金库钱包。

> **Note:**
>
> **即将推出。** 我们计划提供专门的导入工具。以下步骤使用当前的 API。

## 概念对照

| Coinbase Commerce | InfraIO Pay |
| --- | --- |
| Charge | [结账会话](https://docs.infraio.xyz/zh-CN/concepts/sessions)(API)或[支付链接](https://docs.infraio.xyz/zh-CN/payment-links/overview)(无需代码) |
| Checkout | [托管收银台](https://docs.infraio.xyz/zh-CN/checkout/overview) |
| Webhook 订阅 | 带 HMAC 签名的 [Webhook 端点](https://docs.infraio.xyz/zh-CN/webhooks/overview) |
| Charge `confirmed` 事件 | `payment.settled` |
| Charge `expired` 事件 | `checkout.expired` |
| API 密钥 | [API 密钥对](https://docs.infraio.xyz/zh-CN/security/api-keys)(`pk_` + `sk_`) |

## 三步迁移

### 创建账户和密钥

在 [app.infraio.xyz](https://app.infraio.xyz) 注册,添加资金库钱包,并生成测试密钥和
Webhook 密钥。

### 用会话替换创建 charge 的调用

把创建 charge 的调用替换为创建结账会话,简单场景也可以直接使用支付链接。把你自己的
订单 ID 存入 `external_ref`。见[快速入门](https://docs.infraio.xyz/zh-CN/get-started/quickstart)。

### 切换你的 Webhook 处理程序

验证[签名](https://docs.infraio.xyz/zh-CN/webhooks/signature-verification),并在 `payment.settled` 时履约。
先在测试网上测试,然后切换到生产密钥。

你的费用详见[定价与费用](https://docs.infraio.xyz/zh-CN/concepts/pricing)。
