Skip to main content
C# SDK は、C# で書かれたアプリケーションから Dodo Payments REST API へ便利にアクセスできるようにします。強い型付け、非同期タスクベース API、自動リトライ、および包括的なエラー処理を特徴としています。

インストール

NuGetからパッケージをインストールします。
このSDKは .NET 8.0 以降が必要です。ASP.NET Core、コンソールアプリケーション、その他の .NET プロジェクトタイプで動作します。

クイックスタート

クライアントを初期化し、チェックアウト セッションを作成します:
API キーは常に、環境変数、ユーザー シークレット、または Azure Key Vault を使用して安全に保管してください。ソース コードにハードコードしたり、バージョン管理にコミットしたりしないでください。

主な機能

Async/Await

ノンブロッキング操作のための完全な async Task ベースの API

Strong Typing

Nullable 参照型を活用した包括的な型安全性

Smart Retries

 一時的なエラーに対する指数バックオフでの自動リトライ

Error Handling

 正確なエラーマネジメントのための組み込み例外階層

構成

環境変数

.env

マニュアル設定

環境

ライブモードとテストモードを切り替えます。

リトライ

SDK はデフォルトで 2 回、指数バックオフを伴って自動的にリトライします。接続エラーやステータスコード 408、409、429、および 5xx に対してリトライします。

タイムアウト

リクエストはデフォルトで1分後にタイムアウトします。

リクエストごとのオーバーライド

単一のリクエスト用に設定を一時的に変更するには、WithOptions を使用します。

共通の操作

チェックアウトセッションを作成する

顧客を管理する

サブスクリプションを処理する

POST /subscriptions(SDKのsubscriptions.createメソッド)は非推奨です。既存のインテグレーションでは引き続き動作しますが、新しいインテグレーションではCheckout Sessionを介してサブスクリプションを作成してください。
Billingには、少なくとも2文字のISO Countryコードが必要です。既存の顧客を紐付けるにはAttachExistingCustomerを使用し、新しく作成するにはNewCustomerを使用してください。ProductPriceは通貨の最小単位で指定します。

エラーハンドリング

SDKはHTTPステータスコードに基づいて、特定の例外をスローします。すべての4xxエラーはDodoPayments4xxExceptionを継承します。 その他の例外タイプ:
  • DodoPaymentsIOException: I/Oネットワークエラー
  • DodoPaymentsInvalidDataException: 解析済みデータの解釈に失敗
  • DodoPaymentsException: すべての例外の基底クラス

ページネーション

自動ページネーション

すべてのページにわたるすべての結果を、Paginateメソッドを使用して反復処理できます。このメソッドはIAsyncEnumerableを返します。

手動ページネーション

ASP.NET Coreの統合

DIコンテナにクライアントを登録します。
Program.cs
appsettings.json
開発時には、キーをappsettings.jsonに保存する代わりに、ユーザーシークレットを使用してください。

リソース

NuGet Package

NuGet Galleryでパッケージを見る

GitHub Repository

ソースコードを確認してコントリビュートする

API Reference

APIドキュメント全体を確認する

Discord Community

ヘルプを得て開発者とつながる

サポート

C# SDKについてサポートが必要ですか?
最終更新日 2026年8月17日