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. 환산: 실시간 FX rates를 사용해 가격이 동적으로 환산됩니다
  4. 표시: 최종 결제 금액이 결제 전에 투명하게 표시됩니다
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. 업데이트된 가격과 절약 금액이 명확하게 표시됩니다
checkout의 할인 코드 입력

API 통합

하나 이상의 stacked discount code를 미리 적용하거나 discount input field를 활성화합니다:
discount_codes는 순서대로 누적 적용되는 최대 20개의 code 배열을 허용합니다. 단일 discount_code field는 deprecated 상태지만 여전히 작동하므로 기존 integration을 즉시 변경할 필요는 없습니다. stacking과 더 풍부한 response shape를 사용하려면 편리한 시점에 discount_codes로 마이그레이션하세요.

Discount Codes

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

Validate Discount by Code

code name을 사용해 할인을 조회하고 검증하세요.

스마트 주소 수집

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

사용 가능한 옵션

주소 수집은 compliance를 보장하면서 전환을 극대화할 수 있도록 속도, 정확성 및 전 세계 지원 범위의 균형을 맞춥니다.

Minimal Address Mode

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

Minimal Address Reference

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

전화번호 수집

checkout session feature flags를 사용하여 checkout에 전화번호 필드가 표시되는지, 그리고 필수인지 여부를 제어할 수 있습니다.
require_phone_number: trueallow_phone_number_collection: true를 요구합니다. phone collection이 비활성화된 상태에서 phone number가 required인 session은 API에서 거부됩니다.
지원, fraud review 또는 compliance를 위해 검증된 연락 채널이 필요한 B2B SaaS, 규제 산업 또는 모든 flow에서 require_phone_number를 사용하세요.

Custom Fields

custom form fields를 정의하여 checkout 중 고객으로부터 추가 정보를 수집할 수 있습니다. 회사명, 팀 규모, 추천 출처 또는 기타 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 구성 및 response 액세스에 대해 자세히 알아보세요.

개인정보 보호정책 및 약관 동의

법률 및 compliance의 투명성을 보장하기 위해:
  • Privacy PolicyBuyer Terms 링크가 checkout에 명확하게 표시됩니다
  • 고객은 결제를 완료하기 전에 이를 명시적으로 확인합니다
이는 GDPR compliance를 비롯한 전 세계 소비자 보호 및 data privacy 요구사항을 충족하는 데 도움이 됩니다.

Collection Checkout

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

작동 방식

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

Collection Checkout 생성

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

Product Collections

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

Checkout Session 구성

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

Checkout Sessions API

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

Checkout Integration Guide

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

Checkout Theme 사용자 지정

API를 통해 checkout session을 생성할 때 customization.theme_config parameter를 사용하여 checkout 페이지의 appearance를 brand에 맞게 사용자 지정할 수 있습니다. light 및 dark mode 모두에 대해 color, font, border radius 및 button text를 구성하세요.
사용자 지정 theme이 적용된 checkout 페이지

Design & Theme Customization

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

Theme 구성 옵션

Color 구성(Light/Dark Mode)

각 mode(lightdark)는 다음 color properties를 지원합니다:
모든 color field는 표준 CSS color format을 허용합니다:
  • 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 property를 지정할 필요는 없습니다. 지정하지 않은 property에는 기본 theme 값이 사용됩니다.
마지막 수정일 2026년 7월 31일