<!-- Source: https://docs.infraio.xyz/ko/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/ko/concepts/sessions) (API) 또는 [결제 링크](https://docs.infraio.xyz/ko/payment-links/overview) (코드 불필요) |
| Checkout | [호스팅 결제 페이지](https://docs.infraio.xyz/ko/checkout/overview) |
| Webhook subscription | HMAC 서명이 적용된 [웹훅 엔드포인트](https://docs.infraio.xyz/ko/webhooks/overview) |
| Charge `confirmed` 이벤트 | `payment.settled` |
| Charge `expired` 이벤트 | `checkout.expired` |
| API key | [API 키 쌍](https://docs.infraio.xyz/ko/security/api-keys) (`pk_` + `sk_`) |

## 3단계 마이그레이션

### 계정과 키 생성

[app.infraio.xyz](https://app.infraio.xyz)에 가입하고 트레저리 지갑을 추가한 뒤
테스트 키와 웹훅 시크릿을 생성하세요.

### Charge 생성을 세션으로 교체

Charge를 생성하는 호출을 체크아웃 세션으로 바꾸거나, 간단한 경우에는 결제
링크를 사용하세요. 자체 주문 ID는 `external_ref`에 저장합니다.
[빠른 시작](https://docs.infraio.xyz/ko/get-started/quickstart)을 참고하세요.

### 웹훅 핸들러 전환

[서명](https://docs.infraio.xyz/ko/webhooks/signature-verification)을 검증하고 `payment.settled`에서
주문을 처리하세요. 테스트넷에서 테스트한 후 라이브 키로 전환합니다.

수수료는 [요금 및 수수료](https://docs.infraio.xyz/ko/concepts/pricing)에서 확인하세요.
