Installation
Install the package from NuGet:The SDK requires .NET 8.0 or later. It works with ASP.NET Core, Console applications, and other .NET project types.
Quick Start
Initialize the client and create a checkout session:Core Features
Async/Await
Full async Task-based API for non-blocking operations
Strong Typing
Comprehensive type safety with nullable reference types
Smart Retries
Automatic retries with exponential backoff for transient errors
Error Handling
Built-in exception hierarchy for precise error management
Configuration
Environment Variables
.env
Manual Configuration
Environments
Switch between live and test mode:Retries
The SDK automatically retries 2 times by default with exponential backoff. It retries on connection errors and status codes 408, 409, 429, and 5xx.Timeouts
Requests time out after 1 minute by default.Per-Request Overrides
Temporarily modify configuration for a single request usingWithOptions:
Common Operations
Create a Checkout Session
Manage Customers
Handle Subscriptions
Billing richiede almeno il codice ISO a due lettere Country. Usa AttachExistingCustomer per associare un cliente esistente oppure NewCustomer per crearne uno. ProductPrice è espresso nella denominazione più bassa della valuta.Gestione degli errori
L’SDK genera eccezioni specifiche in base al codice di stato HTTP. Tutti gli errori 4xx ereditano daDodoPayments4xxException.
Altri tipi di eccezione:
DodoPaymentsIOException: errori di rete I/ODodoPaymentsInvalidDataException: impossibilità di interpretare i dati analizzatiDodoPaymentsException: classe base per tutte le eccezioni
Paginazione
Paginazione automatica
Itera su tutti i risultati di tutte le pagine usando il metodoPaginate, che restituisce un IAsyncEnumerable:
Paginazione manuale
Integrazione con ASP.NET Core
Registra il client nel container DI:Program.cs
appsettings.json
Risorse
NuGet Package
Visualizza il pacchetto nella NuGet Gallery
GitHub Repository
Visualizza il codice sorgente e contribuisci
API Reference
Documentazione completa dell’API
Discord Community
Ricevi assistenza e connettiti con gli sviluppatori
Assistenza
Hai bisogno di assistenza con l’SDK C#?- Discord: unisciti al nostro server della community per ricevere assistenza in tempo reale
- Email: contattaci all’indirizzo support@dodopayments.com
- GitHub: apri una segnalazione nel repository