Skip to main content
Gli SDK server ufficiali di Dodo Payments sono disponibili in nove linguaggi. SDK checkout separati aprono il checkout ospitato da app Android, iOS, React Native e Flutter.

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.
2

Initialize the Client

Leggi la tua chiave API dalla variabile d’ambiente DODO_PAYMENTS_API_KEY. Gli esempi si connettono alla modalità di test; consulta Modalità di test e modalità live.
Per Java, Kotlin, C# e Ruby, consulta la configurazione del client nella pagina di ogni SDK.
Conserva le chiavi API nelle variabili d’ambiente o in un secrets manager. Non inserirle mai nel version control.
3

Create a Checkout Session

Crea una sessione di checkout e reindirizza il cliente a checkout_url.
Per la stessa chiamata in altri linguaggi, nonché per i payment link e i webhook, consulta la Guida all’integrazione.

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.
Installala su macOS o Linux con:

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.

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

Contributi

Ogni repository SDK accetta contributi. La maggior parte include un file CONTRIBUTING.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.
Ultima modifica il 26 settembre 2026