체크아웃은 장바구니를 결제 가능한 주문서로 바꾸는 커머스의 입구예요. 결제창만 띄우는 것이 아니라 상품·고객·주문 컨텍스트를 먼저 만들고, 결제 완료 후 주문 운영까지 이어가요.
개념 배경
결제 SDK와 커머스 SDK 중 무엇을 선택해야 하는지는 블로그에서 의사결정 관점으로 다뤄요.
- 결제만 붙이면 되나요, 주문까지 해야 하나요? — payments 결제창과 commerce checkout 선택 기준
핵심 요약
- 체크아웃은
catalog → checkout → orders흐름의 가운데에 있어요. - 상품을 카탈로그에 등록해 두면 프론트엔드는 수량·고객·배송 정보를 정리해 주문서를 열 수 있어요.
- 결제가 끝나면
order_id를 기준으로 서버 검증, 웹훅 보정, 취소·환불 흐름이 이어져요. - 기존 주문 시스템이 이미 있다면 결제 SDK가 더 단순할 수 있고, 주문 백엔드까지 줄이고 싶다면 커머스 체크아웃이 맞아요.
체크아웃 흐름
체크아웃에서 중요한 건 프론트엔드 콜백만으로 주문을 확정하지 않는 거예요. 결제 완료 이벤트를 받으면 서버가 order_id로 주문을 다시 조회하고, 내부 장바구니·금액·고객 기준과 맞는지 확인해야 해요.
결제창과 무엇이 다른가
| 항목 | 결제 SDK 결제창 | 커머스 체크아웃 |
|---|---|---|
| 중심 개념 | 결제 승인과 영수증 | 상품 기반 주문 |
| 상품 정보 | 결제 요청마다 직접 구성 | 카탈로그에 등록하고 재사용 |
| 주문 생성 | 서비스가 직접 구현 | 커머스 주문 흐름으로 연결 |
| 운영 | receipt_id 검증·취소 중심 |
order_id 조회·취소·환불 중심 |
| 적합한 경우 | 기존 주문 시스템 보유 | 신규 커머스 백엔드 구축 |
결제 SDK는 결제 기능을 붙이는 도구예요. 커머스 체크아웃은 결제 전후의 주문 흐름까지 묶는 도구예요.
링크페이와의 차이
체크아웃과 링크페이는 경쟁 관계가 아니라 진입 방식이 달라요.
| 항목 | 체크아웃 | 링크페이 |
|---|---|---|
| 진입 위치 | 웹·앱 안의 주문서 | 문자·카카오톡·이메일·상담 링크 |
| 주체 | 사용자가 서비스 안에서 직접 결제 | 운영자 또는 서버가 링크를 발송 |
| 적합한 장면 | 쇼핑몰, 앱 내 구매, 회원 결제 | 견적 결제, 비회원 결제, 오프라인 수납 |
| 다음 문서 | 주문서 요청 | 링크페이 |
다음 단계
- 체크아웃 빠른 매뉴얼으로 최소 연동을 붙여요.
- 카탈로그 이해하기에서 상품 구조를 정리해요.
- 주문 이해하기에서 결제 이후 운영 범위를 확인해요.
- 결제창만 필요하면 결제 연동 시작하기를 봐요.
