Skip to main content
공식 Dodo Payments server SDK는 9개 언어로 제공됩니다. 별도의 checkout SDK를 사용하면 Android, iOS, React Native, Flutter 앱에서 호스팅된 checkout을 열 수 있습니다.

TypeScript

promise 기반 API와 auto-pagination을 지원하는 Node.js용 type-safe SDK입니다.

Python

Python 3.9+의 async/await를 지원하는 Pythonic interface입니다.

Go

context 지원과 강력한 typing을 제공하는 idiomatic Go interface입니다.

PHP

PHP 8.1+을 준수하는 PSR-4 SDK입니다.

Java

Maven 및 Gradle을 지원하는 Java 8+용 thread-safe SDK입니다.

Kotlin

coroutine과 null safety를 지원하는 Kotlin SDK입니다.

C#

async Task 기반 API를 제공하는 .NET Standard 2.0+용 Type-safe SDK입니다.

Ruby

Ruby convention을 따르는 Ruby SDK입니다.

Rust

Rust 1.75+용 Tokio 및 reqwest 기반 async-first SDK입니다.

빠른 시작

1

Install the SDK

패키지 관리자를 사용해 사용 중인 언어에 맞는 SDK를 설치합니다.
Maven coordinates와 버전별 옵션은 각 SDK 페이지를 참조하세요.
2

Initialize the Client

DODO_PAYMENTS_API_KEY 환경 변수에서 API key를 읽습니다. 예시는 test mode에 연결됩니다. 자세한 내용은 Test Mode vs Live Mode를 참조하세요.
Java, Kotlin, C#, Ruby의 경우 각 SDK 페이지의 client 설정을 참조하세요.
API key는 환경 변수 또는 secrets manager에 보관하세요. version control에 절대 commit하지 마세요.
3

Create a Checkout Session

checkout session을 생성하고 고객을 반환된 checkout_url로 redirect합니다.
다른 언어에서 동일한 call을 수행하는 방법과 payment links 및 webhooks에 대한 내용은 Integration Guide를 참조하세요.

주요 기능

모든 backend SDK에는 다음이 포함됩니다:
  • Type Safety: compile-time safety와 향상된 IDE 지원을 위한 강력한 typing입니다.
  • Error Handling: API가 반환한 HTTP status와 error body를 제공하는 typed errors입니다.
  • Authentication: 환경 변수에서 읽는 API key authentication입니다.
  • Async Support: 해당하는 경우 최신 async/await 패턴을 지원합니다.
  • Auto-Pagination: list response에 대한 자동 pagination입니다.
  • Usage Events: usage-based billing을 위한 usage event 전송 메서드입니다.
  • Test Mode: client를 test mode로 지정하는 설정으로, 실제 자금이 이동하지 않습니다.

Mobile Checkout SDK

native Android, iOS, React Native 및 Flutter 앱에서는 mobile checkout SDK를 사용하세요. 이 SDK는 Dodo의 hosted checkout page를 플랫폼의 실제 browser surface(WebView가 아님)에서 열기 때문에 Apple Pay와 Google Pay가 open web에서와 동일하게 작동합니다. 네 가지 mobile SDK는 모두 동일한 contract를 공유합니다. start(...)는 typed CheckoutResult를 반환하고, 어느 SDK도 API key를 보유하지 않으며 API를 직접 호출하지 않습니다.

Android

Chrome Custom Tab을 여는 Kotlin SDK입니다. minSdk 23이 필요합니다.

iOS

SFSafariViewController를 여는 Swift SDK입니다. iOS 16+가 필요합니다.

React Native

두 native core에서 작동하는 Turbo Module입니다. React Native 0.76+가 필요합니다.

Flutter

두 native core에서 작동하는 Pigeon channel입니다. Flutter 3.44+가 필요합니다.

Mobile Integration Guide

backend checkout session부터 callback scheme 설정까지 지원하는 end-to-end mobile payment flow입니다.

Command-Line Interface

Dodo CLI는 terminal에서 payments, customers 및 webhooks를 관리합니다. interactive TUI, AI assistant 및 webhook testing tools를 제공합니다.

CLI

AI assistant와 webhook testing을 지원하는 interactive terminal client입니다.
다음 명령어를 사용해 macOS 또는 Linux에 설치합니다:

Framework Adaptors

Adaptor는 framework에 checkout, Customer Portal 및 webhook handler를 추가합니다.

권장 Framework

Next.js

App Router에서 checkout, Customer Portal 및 webhooks를 처리하는 route handler입니다.

Better Auth

사용자가 가입할 때 customer를 생성하고 auth flow에 checkout과 Customer Portal을 추가합니다.

Supabase

auth, database schema, webhooks 및 pricing page가 포함된 Next.js 및 Supabase starter입니다.

Convex

Convex backend를 위한 checkout, Customer Portal 및 webhook function입니다.

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Bun

Node.js SDK에서 Migration

TypeScript SDK는 legacy Node.js SDK를 대체합니다. Node.js SDK를 사용 중이라면 migration guide를 참조하여 integration을 업데이트하세요.

도움말

기여

각 SDK repository는 contribution을 받습니다. 대부분의 repository에는 bug 보고, feature 요청, pull request 제출, test 실행 및 code style 규칙에 대한 지침이 포함된 CONTRIBUTING.md 파일이 있습니다. 개별 SDK 페이지를 방문하여 GitHub repository와 contribution 지침을 확인하세요.
마지막 수정일 2026년 9월 26일