<!-- Source: https://docs.infraio.xyz/zh-TW/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 | [結帳 session](https://docs.infraio.xyz/zh-TW/concepts/sessions)（API）或[付款連結](https://docs.infraio.xyz/zh-TW/payment-links/overview)（免寫程式） |
| Checkout | [託管結帳頁](https://docs.infraio.xyz/zh-TW/checkout/overview) |
| Webhook 訂閱 | 具 HMAC 簽章的 [Webhook 端點](https://docs.infraio.xyz/zh-TW/webhooks/overview) |
| Charge `confirmed` 事件 | `payment.settled` |
| Charge `expired` 事件 | `checkout.expired` |
| API 金鑰 | [API 金鑰組](https://docs.infraio.xyz/zh-TW/security/api-keys)（`pk_` + `sk_`） |

## 三步驟完成遷移

### 建立帳號與金鑰

到 [app.infraio.xyz](https://app.infraio.xyz) 註冊，新增資金庫錢包，並產生測試金鑰與
webhook secret。

### 以 session 取代 charge 建立

把建立 charge 的呼叫換成結帳 session，簡單的情境也可以改用付款連結。
請把你自己的訂單 ID 存入 `external_ref`。請見[快速入門](https://docs.infraio.xyz/zh-TW/get-started/quickstart)。

### 切換你的 webhook 處理程式

驗證[簽章](https://docs.infraio.xyz/zh-TW/webhooks/signature-verification)，並在收到
`payment.settled` 時履約。先在測試網上測試，再切換到正式金鑰。

你的費用請見[定價與費用](https://docs.infraio.xyz/zh-TW/concepts/pricing)。
