Skip to main content
결제 페이지
Dodo Payments checkout은 디지털 제품과 SaaS를 위해 설계된 호스팅 결제 페이지입니다. 통화 변환, 세금 계산, 할인 코드, 주소 수집 및 결제 수단 선택을 처리합니다. API 또는 대시보드를 통해 checkout session을 생성하면 고객은 안전하고 브랜드가 적용된 페이지에서 결제를 완료합니다.

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와 같이 깔끔한 끝자리로 반올림됩니다.
checkout의 통화 선택기
Adaptive Currency를 활성화하려면 Settings → Business로 이동하여 켜세요.

Adaptive Currency

지원되는 통화, 변환 수수료 및 환불 처리입니다.

다국어 Checkout

Checkout은 22개 언어를 지원합니다. 고객은 페이지에서 직접 언어를 전환할 수 있으며 UI 텍스트, 라벨 및 system message가 현지화됩니다. 아랍어와 히브리어에서는 checkout이 오른쪽에서 왼쪽으로 렌더링되며 전체 레이아웃이 좌우 반전됩니다. 이메일 주소, 코드, 전화번호는 자연스러운 읽기 순서를 유지합니다.
checkout의 언어 선택기

지원 언어

특정 언어를 강제로 사용하려면 checkout session을 생성할 때 customization.force_language을 설정하세요. 자세한 내용은 Checkout Sessions API를 참조하세요.

자동 세금 계산

GST, VAT 및 sales tax 요구 사항을 준수할 수 있도록 고객의 청구지 주소를 기준으로 세금이 자동 계산됩니다. 해당하는 경우 고객의 국가와 지역에 따라 세금 규칙이 적용됩니다. 고객이 국가를 변경하거나 주소를 업데이트하면 세액이 자동으로 업데이트됩니다. 최종 세금 내역은 결제 전에 명확하게 표시됩니다.
세금 계산은 완전히 자동화되어 있습니다. 표준 디지털 상품 및 SaaS 제품에는 수동 구성이 필요하지 않습니다.

사업자 세금 ID 지원

B2B 거래의 경우 checkout에서 고객이 사업자 세금 ID(예: VAT 또는 GST 번호)를 입력할 수 있습니다. 입력하면 세금 ID가 실시간으로 검증되고 해당 세금 면제 또는 reverse-charge 규칙이 자동으로 적용됩니다.
checkout의 사업자 세금 ID 입력

Discount Codes

고객은 dashboard에서 생성한 할인 코드 또는 프로모션 코드를 적용할 수 있습니다. 할인은 즉시 검증되며 업데이트된 가격이 표시됩니다. 제품에서 Purchasing Power Parity가 활성화된 경우 할인은 기본 가격이 아닌 PPP 조정 가격에 적용됩니다.
checkout의 할인 코드 입력
할인 코드를 미리 적용하거나 API를 통해 할인 입력 필드를 활성화할 수 있습니다:
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 계산에 필요한 지역에서만 수집
그 외의 모든 주소 필드는 건너뜁니다.
checkout에서 국가 및 ZIP/우편번호 필드만 표시되는 최소 주소 모드
전체 주소 수집이 기본값입니다. 완전한 청구 정보가 필요하지 않은 디지털 제품 및 SaaS 흐름에서는 minimal_address를 활성화하세요.

전화번호 수집

checkout에 전화번호 필드가 표시되는지, 그리고 필수 입력인지 제어합니다.
require_phone_number: true에는 allow_phone_number_collection: true가 필요합니다. 전화번호 수집이 비활성화된 상태에서 전화번호가 필수인 session은 API에서 거부됩니다.

사용자 정의 필드

사용자 정의 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_collection_id를 사용할 때는 빈 product_cart 배열을 전달하세요. session 생성 시 할인 코드를 미리 적용할 수 없습니다.

Product Collections

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 session의 전체 API reference.

Checkout Integration Guide

checkout 통합을 위한 단계별 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을 참조하세요.
사용자 지정 theme이 적용된 checkout page

Design & Theme Customization

미리 구성된 theme, typography, 색상 및 live preview를 사용해 dashboard에서 시각적으로 theme을 구성합니다.

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

예시

모든 색상 property를 지정할 필요는 없습니다. 지정하지 않은 property에는 기본 theme 값이 사용됩니다.
마지막 수정일 2026년 10월 8일