Skip to main content
결제 페이지
Dodo Payments 체크아웃은 디지털 제품 및 SaaS 비즈니스를 위해 전환율에 최적화된, 전 세계 규정 준수 체크아웃입니다. 여러 통화, 언어, 세금, 할인, 애드온 및 비즈니스 친화적인 규정 준수 워크플로를 지원합니다.

Checkout Sessions API

호스티드 체크아웃 세션을 프로그래밍 방식으로 생성합니다.

Preview Checkout

세션 생성 전에 가격과 세금을 계산합니다.

Payment Methods

지원되는 결제 수단 및 구성 옵션.
Checkout Sessions API를 통해 생성된 Checkout 링크는 재사용할 수 없으며 24시간 이내에 만료됩니다. 각 고객과 각 결제 시도마다 새로운 세션을 생성하세요.

Adaptive Currency

Adaptive Currency를 사용하면 고객이 선호하는 현지 통화로 결제할 수 있어 신뢰도와 전환율을 높일 수 있습니다.

작동 방식

  1. 활성화: Settings → Business에서 Adaptive Currency를 활성화합니다
  2. 선택: 고객은 checkout에서 직접 통화를 전환할 수 있습니다
  3. PPP 적용: 제품에서 Purchasing Power Parity가 활성화된 경우 국가별 비율이 기본 가격을 낮춥니다
  4. 변환: 가격(또는 PPP가 조정된 가격)이 실시간 FX rates에 따라 고객의 통화로 변환됩니다
  5. 반올림: Charm Pricing이 활성화된 경우 변환된 금액이 49.99와 같이 깔끔한 끝자리로 반올림됩니다
  6. 표시: 최종 결제 금액이 결제 전에 투명하게 표시됩니다
checkout의 통화 선택기

Adaptive Currency

지원되는 통화, 환산 수수료 및 환불 처리에 대해 자세히 알아보세요.

다국어 Checkout

Dodo Payments는 checkout 페이지에서 여러 언어를 지원하므로 고객이 익숙한 언어로 결제를 완료할 수 있습니다.
checkout의 언어 선택기

주요 특징

  • checkout에서 바로 사용할 수 있는 언어 선택기
  • UI 텍스트, 레이블 및 시스템 메시지가 현지화됩니다
  • 접근성과 국제 전환율을 향상합니다

지원 언어

checkout 페이지는 21개 언어를 지원합니다:
checkout session을 생성할 때 force_language parameter를 설정하여 checkout에서 특정 언어를 강제할 수 있습니다. 자세한 내용은 Checkout Sessions API를 참조하세요.

자동 세금 계산

세금은 고객의 청구지 위치를 기준으로 자동 계산되므로 수동 설정 없이 GST, VAT 및 판매세 요구사항을 준수할 수 있습니다.

세금 계산 방식

1

Location Detection

세금 규칙은 고객의 국가(해당하는 경우 지역)를 기준으로 적용됩니다.
2

Dynamic Updates

다음과 같은 경우 세금 금액이 자동으로 업데이트됩니다:
  • 국가가 변경된 경우
  • 주소가 업데이트된 경우
3

Transparent Display

최종 세금 내역이 결제 전에 명확하게 표시됩니다.
세금 계산은 완전히 자동화되어 있습니다. 일반적인 digital goods 및 SaaS products에는 수동 구성이 필요하지 않습니다.

Business Tax ID 지원

등록된 business의 경우 checkout에서 고객이 Business Tax ID(예: VAT/GST number)를 입력할 수 있습니다.

Tax ID를 입력하면 어떻게 되나요

  • 세금 자격이 실시간으로 검증됩니다
  • 해당하는 세금 면제 또는 reverse-charge rules가 적용됩니다
  • checkout에서 세금 금액이 즉시 업데이트됩니다
checkout의 Business Tax ID 입력
이는 business 고객이 세금 면제 대상일 수 있는 B2B SaaS 및 digital services에 특히 유용합니다.

할인 코드

고객은 dashboard에서 생성한 discount 또는 promo code를 checkout 페이지에서 직접 적용할 수 있습니다.

Checkout 경험

  1. 고객이 discount code를 입력합니다
  2. 할인이 즉시 검증됩니다
  3. 업데이트된 가격과 절약 금액이 명확하게 표시됩니다
제품에서 Purchasing Power Parity가 활성화된 경우 할인은 기본 가격이 아니라 PPP가 조정된 가격에 적용됩니다.
checkout의 할인 코드 입력

API 통합

하나 이상의 스택형 할인 코드를 미리 적용하거나 할인 입력 필드를 활성화합니다:
discount_codes는 순서대로 스택되는 최대 20개의 코드 배열을 허용합니다. 단일 discount_code 필드는 deprecated 상태이지만 여전히 작동합니다. 기존 integration은 즉시 변경할 필요가 없습니다. 스택 기능과 더 풍부한 response shape를 사용하려면 편리한 시점에 discount_codes로 마이그레이션하세요.

Discount Codes

할인 코드를 생성하고 관리하는 방법을 알아보세요.

Validate Discount by Code

코드 이름을 사용하여 할인을 조회하고 검증하세요.

스마트 주소 수집

checkout은 더 빠른 완료를 위해 유연한 주소 입력을 지원합니다.

사용 가능한 옵션

주소 수집은 compliance를 보장하면서 conversion을 극대화할 수 있도록 속도, 정확성, 글로벌 범위 간의 균형을 맞춥니다.

Minimal Address Mode

conversion을 극대화하려면 최소 주소 수집을 활성화하여 checkout의 마찰을 줄이세요. minimal_addresstrue로 설정되면 checkout은 다음 항목만 수집합니다:
  • 국가 — tax determination을 위해 항상 필요
  • ZIP/우편번호 — sales tax, VAT 또는 GST 계산에 필요한 지역에서만 수집
그 외 모든 주소 필드(street, city, state)는 생략되어 checkout 완료 속도가 크게 향상됩니다.
checkout에서 국가와 ZIP/우편번호 필드만 표시되는 최소 주소 모드
전체 주소 수집이 기본값으로 유지됩니다. 전체 billing details가 필요하지 않은 digital products 및 SaaS flows에서는 minimal_address를 활성화하세요.

Minimal Address Reference

Checkout Sessions API guide에서 전체 minimal_address parameter reference를 확인하세요.

전화번호 수집

checkout에서 전화번호 필드가 표시되는지, 그리고 필수인지 여부를 checkout session feature flags를 사용하여 제어합니다.
require_phone_number: true에는 allow_phone_number_collection: true가 필요합니다. phone collection이 비활성화된 상태에서 phone number가 필수인 session은 API에서 거부됩니다.
B2B SaaS, regulated industries 또는 support, fraud review나 compliance를 위해 verified contact channel이 필요한 모든 flow에서 require_phone_number를 사용하세요.

Custom Fields

custom form fields를 정의하여 checkout 중 고객으로부터 추가 정보를 수집합니다. company name, team size, referral source 또는 기타 business-specific information과 같은 데이터를 수집할 때 유용합니다.

사용 가능한 필드 유형

예시

고객 응답은 webhook payload(payment.succeeded, subscription.active)와 custom_field_responses array를 통한 API response에 자동으로 포함됩니다. checkout session당 최대 5개의 custom field를 정의할 수 있습니다.

Custom Fields Guide

custom field configuration 및 response access에 대해 자세히 알아보세요.

Privacy Policy 및 Terms Acceptance

법률 및 compliance 관련 투명성을 보장하려면 다음을 따르세요:
  • Privacy PolicyBuyer Terms 링크가 checkout에 명확하게 표시됩니다
  • 고객은 결제를 완료하기 전에 이를 명시적으로 확인합니다
이를 통해 GDPR compliance를 비롯한 글로벌 consumer protection 및 data privacy requirements를 충족하는 데 도움이 됩니다.

Collection Checkout

Product Collections는 고객이 단일 checkout에서 여러 관련 제품(예: Starter, Pro, Enterprise plans)을 확인하고 선택할 수 있는 통합 checkout experience를 제공합니다.

작동 방식

  1. 모든 제품 표시: 고객에게 collection의 모든 active product가 표시됩니다
  2. 첫 번째 제품 미리 선택: collection의 첫 번째 제품이 자동으로 선택됩니다
  3. 옵션 비교: 고객은 선택하기 전에 pricing과 features를 비교할 수 있습니다
  4. 단일 선택: 제품을 선택하면 standard payment flow로 checkout이 진행됩니다

Collection Checkout 생성

product_collection_id를 사용할 때는 빈 product_cart array를 전달하세요. session creation 시 discount codes를 미리 적용할 수 없습니다.

Product Collections

통합 checkout experience를 위한 product collections 생성 및 관리 방법을 알아보세요.

Checkout Session Configuration

Checkout Sessions API를 사용하여 checkout behavior를 제어합니다:
결제 후 고객은 return_url로 redirect되며, query parameters가 자동으로 추가됩니다 — 여기에는 payment_id 또는 subscription_id, status, emaillicense_key(해당하는 경우)가 포함됩니다. 전체 목록은 Checkout Sessions guide를 참조하세요.

Checkout Sessions API

checkout sessions에 대한 전체 API reference입니다.

Checkout Integration Guide

checkout 통합을 위한 단계별 guide입니다.

Checkout Theme Customization

API를 통해 checkout session을 생성할 때 customization.theme_config parameter를 사용하여 checkout page appearance를 브랜드에 맞게 customize합니다. light 및 dark modes 모두에 대해 colors, fonts, border radius 및 button text를 구성할 수 있습니다.
custom theme이 적용된 checkout page

Design & Theme Customization

사전 구성된 themes, typography, colors 및 live preview를 사용하여 dashboard에서 시각적으로 themes를 구성합니다.
이 section에서는 customization.theme_config를 사용한 server-side API theme configuration을 다룹니다. Checkout SDK(overlay 또는 inline checkout)를 사용하는 경우 camelCase properties를 사용하는 Overlay Checkout의 theme customization section을 참조하세요(예: bg_primary 대신 bgPrimary).

Theme Configuration Options

Color Configuration (Light/Dark Mode)

각 mode(lightdark)는 다음 color properties를 지원합니다:
모든 color fields는 standard CSS color formats를 허용합니다:
  • 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

예시

모든 color properties를 지정할 필요는 없습니다. 지정하지 않은 properties에는 default theme values가 사용됩니다.
마지막 수정일 2026년 8월 26일