콘텐츠로 이동

Hosted Checkout

Hosted Checkout 은 ParaSta 가 호스팅하는 결제 페이지입니다. API 로 Checkout Session 을 생성하고, session.url 로 결제자를 리다이렉트한 뒤, checkout.session.completed 웹훅을 수신합니다.

사용 시점

결제 UI 를 직접 처리하고 싶지 않은 웹 체크아웃
PCI/PII 격리 — 결제자에게 노출되는 결제 데이터를 ParaSta 가 모두 처리
네트워크/토큰 선택을 결제 시점에 결제자에게 위임

필수 파라미터

line_items (배열, 최소 1개) — 결제 대상 항목
success_url — 결제 컨펌 후 이동할 URL
cancel_url — 결제 취소 시 이동할 URL

선택이지만 권장되는 파라미터

customer_email — 영수증 이메일 사전 채움
metadata — 내부 주문 ID 등. 웹훅 이벤트에 그대로 반환됨.
settlement — coin / fiat / splits. 미지정 시 계정 기본값 사용.

URL 플레이스홀더

success_url 안의 {CHECKOUT_SESSION_ID} 는 세션 ID 로 치환됩니다.

https://your-site.com/success?session_id={CHECKOUT_SESSION_ID}

는

https://your-site.com/success?session_id=cs_abc123

으로 치환됩니다.

세션 라이프사이클

Create — status: open, 결제자가 아직 방문하지 않음.
Visited — 결제자가 URL 을 열고 네트워크/토큰을 선택.
Awaiting payment — 결제자가 송금 완료, 멤풀에서 감지됨.
Complete — 완전히 컨펌됨. payment.succeeded, checkout.session.completed 이벤트가 발송됨.

세션은 기본 1시간 후 자동 만료됩니다. 만료된 세션은 checkout.session.expired 를 발송합니다.

함께 보기