
Checkout Sessions API
프로그래밍 방식으로 checkout session을 생성합니다.
Preview Checkout
세션 생성 전에 가격과 세금을 계산합니다.
Payment Methods
지원되는 결제 수단 및 구성입니다.
Integration Guide
checkout 통합 단계별 가이드입니다.
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 session 생성 시
customization.force_language을 설정하세요. 자세한 내용은 Checkout Sessions API를 참조하세요.
자동 세금 계산
고객의 청구지 위치를 기준으로 세금이 자동으로 계산되므로 GST, VAT 및 판매세 요건을 준수할 수 있습니다. 해당되는 경우 고객의 국가와 지역에 따라 세금 규칙이 적용됩니다. 고객이 국가를 변경하거나 주소를 업데이트하면 세액이 자동으로 업데이트됩니다. 최종 세금 내역은 결제 전에 명확하게 표시됩니다.사업자 세금 ID 지원
B2B 거래의 경우 checkout에서 고객이 사업자 세금 ID(예: VAT 또는 GST 번호)를 입력할 수 있습니다. 입력하면 세금 ID가 실시간으로 검증되고 해당 세금 면제 또는 reverse-charge 규칙이 자동으로 적용됩니다.
할인 코드
고객은 대시보드에서 생성한 할인 코드 또는 프로모션 코드를 적용할 수 있습니다. 할인은 즉시 검증되며 업데이트된 가격이 표시됩니다. 제품에서 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/우편번호 — 판매세, 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
사용자 지정 필드 구성 및 응답 액세스입니다.
개인정보 보호정책 및 약관 동의
법률 및 compliance 관련 투명성을 보장하기 위해 다음을 제공합니다:- Privacy Policy 및 Buyer Terms 링크가 checkout에 명확하게 표시됩니다
- 고객은 결제를 완료하기 전에 이를 명시적으로 확인합니다
이를 통해 GDPR compliance를 비롯한 전 세계 소비자 보호 및 데이터 privacy 요건을 충족할 수 있습니다.
제품 컬렉션
Product Collections를 사용하면 고객이 하나의 checkout에서 여러 관련 제품(예: Starter, Pro, Enterprise plan)을 확인하고 선택하는 통합 checkout 경험을 제공할 수 있습니다. 컬렉션을 사용하면 해당 컬렉션의 모든 활성 제품이 표시됩니다. 첫 번째 제품이 미리 선택되며 고객은 선택하기 전에 옵션을 비교할 수 있습니다.Product Collections
제품 컬렉션을 생성하고 관리합니다.
Checkout Session 구성
Checkout Sessions API를 사용하여 checkout 동작을 제어합니다:결제 후 고객은
return_url으로 redirect되며 query parameter가 자동으로 추가됩니다 — 여기에는 payment_id 또는 subscription_id, status, email 및 license_key(해당하는 경우)가 포함됩니다. 전체 목록은 Checkout Sessions guide를 참조하세요.Checkout Sessions API
checkout session에 대한 전체 API reference입니다.
Checkout Integration Guide
checkout 통합 단계별 가이드입니다.
테마 사용자 지정
customization.theme_config parameter를 사용하여 checkout 페이지의 외관을 브랜드에 맞게 사용자 지정할 수 있습니다. 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, typography, 색상 및 live preview를 사용하여 대시보드에서 시각적으로 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) - 명명된 색상:
red,blue,transparent