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