SDKs & Libraries
TypeScript、Python、Go、PHP、Java、Kotlin、C#、Ruby、Rust向けの公式 backend SDK。これらのライブラリにより、API リクエスト、認証、エラーハンドリングが簡単になり、優れた決済体験の構築に集中できます。
Mobile Checkout SDKs
ネイティブアプリを構築していますか?Dodo の hosted checkout を開き、Android、iOS、React Native、Flutterで、1 回の呼び出しで型付きの結果を受け取れます。これらには API key は含まれません。
Environment URL
- Test Mode:
https://test.dodopayments.com - Live Mode:
https://live.dodopayments.com
Test Mode と Live Mode の比較の詳細をご覧ください。
API Key の管理と認証
1
Access API Keys
ダッシュボードで Developer → API Keys に移動して、key を管理します。
2
Generate a New Key
Add API Key を選択し、説明的な名前を入力して、write access を設定します。
- Enable write access(チェックあり):すべての API 操作に対する完全な読み取りおよび書き込み権限
- Enable write access(チェックなし):読み取り専用アクセス。データ(payments、subscriptions、customers、products)の取得のみ可能。リソースの作成や変更はできません。
3
Store Your Key Securely
生成された key をすぐにコピーし、安全に保存されていることを確認します。
4
Authenticate Your API Requests
すべてのリクエストの認証には API keys を使用します。次の authorization 形式を適用してください。
Response Format
Rate Limits
当社の API は、burst protection を備えた dual-window rate limiting system を使用します。制限は、認証方式と business tier に基づいて適用されます。Default Limits(Tier 0)
Business Tiers
API の利用ニーズが高い business には、より高い rate limits を利用できます。Unauthenticated Requests
有効な認証 headers のないリクエストは、IP address に基づいて rate limited されます。Rate Limit Headers
次の response headers で利用状況を監視できます。X-RateLimit-Limit- 許可される最大リクエスト数X-RateLimit-Remaining- 現在の window で残っているリクエスト数X-RateLimit-Reset- rate limit がリセットされる時刻
rate limits を超過すると、API は
429 Too Many Requests response を返します。retry logic には exponential backoff を実装してください。Error Handling
エラーを効果的に管理するには、詳細なガイダンスについて Error Codes と Transaction Failures のセクションを参照してください。Error Codes
エラーの詳細と解決方法を包括的に確認できます。
Transaction Failures
一般的な transaction の問題とその解決方法について理解を深められます。
Webhooks
payment events に関するリアルタイム通知を受け取れます。設定手順については、Webhook Guide をご覧ください。Webhook Guide
リアルタイム通知とイベント処理のために webhooks を設定します。
Related Developer Guides
API を使用して主要な機能を実装する方法を理解するには、包括的なガイドをご覧ください。One-time Payments Integration
one-time payments、checkout sessions、payment links をアプリケーションに統合する方法を学べます
Subscription Integration
subscriptions の実装、plans の管理、subscription lifecycle events の処理に関する完全ガイド
Usage-Based Billing
metered billing と consumption-based pricing models のために meters と usage events を設定します
Webhooks
webhook events でリアルタイム通知を受け取り、ワークフローを自動化します
Checkout Sessions
完全なカスタマイズと高度な機能を備えた、安全な hosted checkout 体験を作成します