
Checkout Sessions API
Preview Checkout
Payment Methods
Integration Guide
Checkout Sessions API를 통해 생성된 Checkout link는 재사용할 수 없습니다. 24시간 후 만료되며,
confirm: true이 설정된 경우에는 15분 후 만료됩니다. 각 고객과 결제 시도마다 새로운 session을 생성하세요.Adaptive Currency
Adaptive Currency를 사용하면 고객이 선호하는 현지 통화로 결제할 수 있어 신뢰도와 전환율을 높일 수 있습니다. 활성화하면 고객은 checkout에서 통화 선택기를 볼 수 있습니다. 가격은 실시간 FX rate에 따라 고객이 선택한 통화로 변환됩니다. 제품에서 Purchasing Power Parity가 활성화된 경우 기본 가격 대신 PPP 조정 가격이 변환됩니다. Charm Pricing이 활성화된 경우 변환된 금액은 49.99와 같이 깔끔한 끝자리로 반올림됩니다.
Adaptive Currency
다국어 Checkout
Checkout은 22개 언어를 지원합니다. 고객은 페이지에서 직접 언어를 전환할 수 있으며 UI 텍스트, 라벨 및 system message가 현지화됩니다. 아랍어와 히브리어에서는 checkout이 오른쪽에서 왼쪽으로 렌더링되며 전체 레이아웃이 좌우 반전됩니다. 이메일 주소, 코드, 전화번호는 자연스러운 읽기 순서를 유지합니다.
지원 언어
특정 언어를 강제로 사용하려면 checkout session을 생성할 때
customization.force_language을 설정하세요. 자세한 내용은 Checkout Sessions API를 참조하세요.
자동 세금 계산
GST, VAT 및 sales tax 요구 사항을 준수할 수 있도록 고객의 청구지 주소를 기준으로 세금이 자동 계산됩니다. 해당하는 경우 고객의 국가와 지역에 따라 세금 규칙이 적용됩니다. 고객이 국가를 변경하거나 주소를 업데이트하면 세액이 자동으로 업데이트됩니다. 최종 세금 내역은 결제 전에 명확하게 표시됩니다.사업자 세금 ID 지원
B2B 거래의 경우 checkout에서 고객이 사업자 세금 ID(예: VAT 또는 GST 번호)를 입력할 수 있습니다. 입력하면 세금 ID가 실시간으로 검증되고 해당 세금 면제 또는 reverse-charge 규칙이 자동으로 적용됩니다.
Discount Codes
고객은 dashboard에서 생성한 할인 코드 또는 프로모션 코드를 적용할 수 있습니다. 할인은 즉시 검증되며 업데이트된 가격이 표시됩니다. 제품에서 Purchasing Power Parity가 활성화된 경우 할인은 기본 가격이 아닌 PPP 조정 가격에 적용됩니다.
discount_codes은 순서대로 중첩 적용되는 최대 20개의 코드 배열을 허용합니다. 단일 discount_code 필드는 deprecated 상태이지만 backward compatibility를 위해 계속 작동합니다.Discount Codes
Validate Discount by Code
스마트 주소 수집
Checkout은 속도, 정확성, 전 세계 지원 범위의 균형을 맞출 수 있는 유연한 주소 입력을 지원합니다.옵션
최소 주소 모드
전환율을 극대화하려면 최소 주소 수집을 활성화해 checkout의 마찰을 줄이세요.minimal_address가 true로 설정되면 checkout은 다음 정보만 수집합니다:
- 국가 — 세금 결정을 위해 항상 필요
- ZIP/우편번호 — sales tax, VAT 또는 GST 계산에 필요한 지역에서만 수집

전체 주소 수집이 기본값입니다. 완전한 청구 정보가 필요하지 않은 디지털 제품 및 SaaS 흐름에서는
minimal_address를 활성화하세요.전화번호 수집
checkout에 전화번호 필드가 표시되는지, 그리고 필수 입력인지 제어합니다.사용자 정의 필드
사용자 정의 form field를 정의해 checkout 중 고객으로부터 추가 정보를 수집할 수 있습니다. 회사명, 팀 규모, 추천 출처 또는 기타 비즈니스별 데이터를 수집할 때 유용합니다.사용 가능한 필드 유형
예시
고객 응답은 webhook payload(
payment.succeeded, subscription.active)와 custom_field_responses 배열을 통한 API response에 자동으로 포함됩니다. checkout session당 최대 5개의 사용자 정의 필드를 정의할 수 있습니다.Custom Fields Guide
Privacy Policy 및 Terms 수락
법률 및 compliance 관련 투명성을 보장하기 위해 다음을 제공합니다:- Privacy Policy 및 Buyer Terms 링크가 checkout에 명확하게 표시됩니다.
- 고객은 결제를 완료하기 전에 이를 명시적으로 확인합니다.
이를 통해 GDPR compliance를 비롯한 전 세계 소비자 보호 및 데이터 privacy 요구 사항을 충족할 수 있습니다.
Product Collections
Product Collections를 사용하면 고객이 하나의 checkout에서 여러 관련 제품(예: Starter, Pro, Enterprise 플랜)을 확인하고 선택하는 통합 checkout 경험을 제공할 수 있습니다. collection을 사용하면 collection의 모든 활성 제품이 표시됩니다. 첫 번째 제품이 미리 선택되며 고객은 선택하기 전에 옵션을 비교할 수 있습니다.Product Collections
Checkout Session 구성
Checkout Sessions API를 사용해 checkout 동작을 제어합니다:결제 후 고객은
return_url으로 리디렉션되며 query parameter가 자동으로 추가됩니다. 여기에는 payment_id 또는 subscription_id, status, email, 그리고 해당하는 경우 license_key가 포함됩니다. 전체 목록은 Checkout Sessions guide를 참조하세요.Checkout Sessions API
Checkout Integration Guide
Theme 사용자 지정
customization.theme_config parameter를 사용해 checkout page의 외관을 브랜드에 맞게 사용자 지정할 수 있습니다. light 및 dark mode 모두에 대해 색상, 글꼴, border radius, button text를 구성하세요.
이 섹션에서는 bg_primary와 같은 property name을 사용하는 server-side API를 다룹니다. session에 설정된 theme은 hosted, overlay, inline checkout에 적용됩니다. bgPrimary와 같은 property name을 사용하는 Checkout SDK의 client-side themeConfig option은 deprecated 상태입니다. Overlay Checkout을 참조하세요.

Design & Theme Customization
Theme 구성 옵션
색상 구성(Light/Dark Mode)
각 mode는 다음 색상 property를 지원합니다:모든 색상 필드는 표준 CSS 색상 형식을 허용합니다:
- Hex:
#fff,#ffffff,#ffffffff - RGB/RGBA:
rgb(255, 255, 255),rgba(255, 255, 255, 0.5) - HSL/HSLA:
hsl(120, 100%, 50%),hsla(120, 100%, 50%, 0.5) - Named colors:
red,blue,transparent