소개 - Dodo Payments Documentation

SDKs & Libraries

TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby, Rust용 공식 백엔드 SDK입니다. 이러한 라이브러리는 API 요청, 인증 및 오류 처리를 간소화하여 훌륭한 결제 경험 구축에 집중할 수 있도록 합니다.

Mobile Checkout SDKs

네이티브 앱을 구축하고 계신가요? Dodo의 호스팅된 checkout을 열고 Android, iOS, React Native, Flutter에서 한 번의 호출로 타입이 지정된 결과를 받아보세요. 이러한 SDK에는 API key가 포함되지 않습니다.

환경 URL

Test Mode: https://test.dodopayments.com
Live Mode: https://live.dodopayments.com

Test Mode와 Live Mode에 대해 자세히 알아보세요.

API Key 관리 및 인증

Access API Keys

대시보드에서 Developer → API Keys로 이동하여 key를 관리하세요.

Generate a New Key

Add API Key를 선택하고 설명이 포함된 이름을 입력한 후 write access를 구성하세요:

Enable write access (선택됨): 모든 API 작업에 대한 전체 read 및 write 권한
Enable write access (선택되지 않음): 읽기 전용 access - 데이터(payments, subscriptions, customers, products)만 가져올 수 있습니다. 리소스를 생성하거나 수정할 수 없습니다.

대시보드 통합, 분석 도구 및 변경 없이 데이터 보기만 필요한 시스템에서는 “Enable write access”를 선택 해제하세요.

Store Your Key Securely

생성된 key를 즉시 복사하고 안전하게 보관하세요.

Authenticate Your API Requests

모든 요청을 인증하려면 API key를 사용하세요. 다음 authorization 형식을 적용하세요:

Authorization: Bearer YOUR_API_KEY

secret API key를 client-side code 또는 public repository에 절대 노출하지 마세요.

Response 형식

{
  "payment_id": "pay_gr4RizvMOXFJ6xca3y2tU",
  "status": "succeeded",
  "total_amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "code": "INVALID_REQUEST",
  "message": "The request contains invalid parameters"
}

Rate Limits

당사의 API는 burst protection을 지원하는 이중 window rate limiting 시스템을 사용합니다. Limit은 authentication method와 business tier에 따라 적용됩니다.

기본 Limit (Tier 0)

Window	Limit
초당 (Burst)	40 requests
분당 (Sustained)	240 requests

Business Tier

API 사용량이 증가한 business에는 더 높은 rate limit을 사용할 수 있습니다:

Tier	Burst (초당)	Sustained (분당)
Tier 0 (기본값)	40	240
Tier 1	100	1,000
Tier 2	500	5,000

business를 더 높은 rate limit tier로 업그레이드하려면 support에 문의하세요.

인증되지 않은 요청

유효한 authentication header가 없는 요청은 IP address를 기준으로 rate limit이 적용됩니다:

Window	Limit
초당 (Burst)	20 requests
분당 (Sustained)	100 requests

Rate Limit Header

다음 response header로 사용량을 모니터링하세요:

X-RateLimit-Limit - 허용되는 최대 requests
X-RateLimit-Remaining - 현재 window에서 남은 requests
X-RateLimit-Reset - rate limit이 재설정되는 시간

rate limit을 초과하면 API는 429 Too Many Requests response를 반환합니다. retry logic에 exponential backoff를 구현하세요.

오류 처리

오류를 효과적으로 관리하려면 자세한 지침이 포함된 Error Codes 및 Transaction Failures 섹션을 참조하세요.

Error Codes

포괄적인 오류 세부 정보와 해결 방법을 확인하세요.

Transaction Failures

일반적인 transaction 문제와 해결 방법에 대한 인사이트를 얻으세요.

Webhooks

payment event에 대한 실시간 알림을 받으세요. 설정 방법은 Webhook Guide를 참조하세요.

Webhook Guide

실시간 알림 및 event 처리를 위해 webhook을 설정하세요.

One-time Payments Integration

일회성 payment, checkout session 및 payment link를 애플리케이션에 통합하는 방법

Subscription Integration

subscription 구현, plan 관리 및 subscription lifecycle event 처리를 위한 전체 guide

Usage-Based Billing

metered billing 및 consumption-based pricing model을 위한 meter와 usage event 설정

Webhooks

webhook event를 사용하여 실시간 알림을 받고 workflow 자동화

Checkout Sessions

완전히 사용자 지정 가능한 고급 기능과 안전한 호스팅 checkout 경험 생성

SDKs & Libraries

Mobile Checkout SDKs

​환경 URL

​API Key 관리 및 인증

​Response 형식

​Rate Limits

​기본 Limit (Tier 0)

​Business Tier

​인증되지 않은 요청

​Rate Limit Header

​오류 처리

Error Codes

Transaction Failures

​Webhooks

Webhook Guide

​관련 Developer Guide

One-time Payments Integration

Subscription Integration

Usage-Based Billing

Webhooks

Checkout Sessions

환경 URL

API Key 관리 및 인증

Response 형식

Rate Limits

기본 Limit (Tier 0)

Business Tier

인증되지 않은 요청

Rate Limit Header

오류 처리

Webhooks

관련 Developer Guide