メインコンテンツへスキップ
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 を使用します。

共通の操作

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

顧客を管理する

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

エラー処理

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

ページネーション

自動ページネーション

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

手動ページネーション

ASP.NET Core との統合

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

リソース

NuGet Package

NuGetギャラリーでパッケージを表示する

GitHub Repository

ソースコードを表示して貢献する

API Reference

完全なAPIドキュメント

Discord Community

開発者とつながり、サポートを得る

サポート

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