TypeScript
SDK type-safe per Node.js con API basata su promise e auto-paginazione.
Python
Interfaccia idiomatica per Python con supporto async/await per Python 3.9+.
Go
Interfaccia Go idiomatica con supporto per context e tipizzazione forte.
PHP
SDK conforme a PSR-4 per PHP 8.1+.
Java
SDK thread-safe per Java 8+ con supporto per Maven e Gradle.
Kotlin
SDK Kotlin con coroutine e null safety.
C#
SDK type-safe per .NET Standard 2.0+ con API basata su Task asincroni.
Ruby
SDK Ruby che segue le convenzioni Ruby.
Rust
SDK async-first basato su Tokio e reqwest per Rust 1.75+.
Avvio rapido
1
Install the SDK
Installa l’SDK per il tuo linguaggio con il relativo package manager.Per le coordinate Maven e le opzioni specifiche per versione, consulta la pagina di ogni SDK.
- TypeScript
- Python
- Go
- PHP
- Java
- Kotlin
- C#
- Ruby
- Rust
2
Initialize the Client
Leggi la tua chiave API dalla variabile d’ambiente Per Java, Kotlin, C# e Ruby, consulta la configurazione del client nella pagina di ogni SDK.
DODO_PAYMENTS_API_KEY. Gli esempi si connettono alla modalità di test; consulta Modalità di test e modalità live.- TypeScript
- Python
- Go
- PHP
- Rust
3
Create a Checkout Session
Crea una sessione di checkout e reindirizza il cliente a Per la stessa chiamata in altri linguaggi, nonché per i payment link e i webhook, consulta la Guida all’integrazione.
checkout_url.Funzionalità principali
Tutti gli SDK backend includono:- Type Safety: tipizzazione forte per la sicurezza in fase di compilazione e un migliore supporto dell’IDE.
- Gestione degli errori: errori tipizzati che espongono lo stato HTTP e il corpo dell’errore restituito dall’API.
- Autenticazione: autenticazione tramite chiave API, letta da una variabile d’ambiente.
- Supporto asincrono: pattern moderni async/await ove applicabile.
- Paginazione automatica: paginazione automatica per le risposte delle liste.
- Eventi di utilizzo: metodi per inviare eventi di utilizzo per la fatturazione basata sull’utilizzo.
- Modalità di test: un’impostazione che indirizza il client alla modalità di test, evitando il trasferimento di denaro reale.
SDK Mobile Checkout
Per le app native Android, iOS, React Native e Flutter, usa gli SDK mobile checkout. Aprono la pagina checkout ospitata da Dodo nella superficie browser reale della piattaforma (non in una WebView), così Apple Pay e Google Pay funzionano nello stesso modo del web aperto. Tutti e quattro gli SDK mobile condividono lo stesso contratto:start(...) restituisce un CheckoutResult tipizzato, nessuno di loro conserva una chiave API e non chiamano mai direttamente l’API.
Android
SDK Kotlin che apre una scheda personalizzata di Chrome. Richiede
minSdk 23.iOS
SDK Swift che apre SFSafariViewController. Richiede iOS 16+.
React Native
Turbo Module su entrambi i core nativi. Richiede React Native 0.76+.
Flutter
Canale Pigeon su entrambi i core nativi. Richiede Flutter 3.44+.
Mobile Integration Guide
Flusso di pagamento mobile end-to-end, dalla sessione checkout del backend alla configurazione dello schema di callback.
Interfaccia a riga di comando
La CLI di Dodo gestisce pagamenti, clienti e webhook dal terminale. Include una TUI interattiva, un assistente AI e strumenti per il testing dei webhook.CLI
Client terminale interattivo con assistente AI e strumenti per il testing dei webhook.
Adattatori per framework
Gli adattatori aggiungono al tuo framework gli handler per checkout, Customer Portal e webhook.Framework consigliati
Next.js
Route handler per checkout, Customer Portal e webhook nell’App Router.
Better Auth
Crea un cliente quando un utente si registra e aggiungi checkout e Customer Portal al tuo flusso di autenticazione.
Supabase
Starter Next.js e Supabase con autenticazione, schema del database, webhook e pagina dei prezzi.
Convex
Checkout, Customer Portal e funzioni webhook per il tuo backend Convex.
All Other Framework Adaptors
All Other Framework Adaptors
SvelteKit
Nuxt
Remix
Express
Fastify
Hono
Astro
TanStack
Bun
Migrazione dall’SDK Node.js
L’SDK TypeScript sostituisce l’SDK Node.js legacy. Se usi l’SDK Node.js, consulta la guida alla migrazione per aggiornare la tua integrazione.
Assistenza
- Discord: unisciti al nostro server della community per ricevere assistenza in tempo reale.
- Email: contattaci all’indirizzo support@dodopayments.com.
- GitHub: apri una issue nel repository dell’SDK pertinente.
- Documentazione: visita il riferimento API.
Contributi
Ogni repository SDK accetta contributi. La maggior parte include un fileCONTRIBUTING.md con linee guida per segnalare bug, richiedere funzionalità, inviare pull request, eseguire test e seguire le convenzioni di stile del codice.
Visita le pagine dei singoli SDK per accedere ai relativi repository GitHub e alle linee guida per i contributi.