Panoramica degli SDK ufficiali - Dodo Payments Documentation

Dodo Payments fornisce SDK ufficiali per diversi linguaggi di programmazione, ciascuno progettato secondo le best practice specifiche del linguaggio e con funzionalità moderne per un’integrazione fluida dei pagamenti.

Utilizza sempre la versione più recente dell’SDK per accedere alle nuove funzionalità e ai miglioramenti. Controlla regolarmente gli aggiornamenti nel tuo gestore di pacchetti per assicurarti di avere accesso a tutte le funzionalità di Dodo Payments.

SDK disponibili

Scegli l’SDK che corrisponde al tuo stack tecnologico:

TypeScript SDK

Integrazione type-safe per TypeScript e Node.js con API basata su promise e impaginazione automatica

Python SDK

Interfaccia idiomatica per Python con supporto per async/await nelle applicazioni Python 3.7+

PHP SDK

SDK conforme a PSR-4 per le moderne applicazioni PHP 8.1+

Go SDK

Interfaccia Go idiomatica con supporto per context e tipizzazione forte

Ruby SDK

Elegante interfaccia Ruby che segue le convenzioni e le best practice di Ruby

Java SDK

SDK robusto e thread-safe per Java 8+ con supporto per Maven e Gradle

Kotlin SDK

SDK Kotlin moderno con coroutine, null safety e funzioni di estensione

C# SDK

SDK type-safe per .NET 8+ con API asincrona basata su Task (Beta)

Rust SDK

SDK progettato per l’asincronia, basato su Tokio e reqwest, con tipizzazione forte per Rust 1.75+

CLI

Interfaccia a riga di comando per interagire con l’API dal tuo terminale

Stai creando un’app mobile? Consulta Mobile Checkout SDKs qui sotto per Android, iOS, React Native e Flutter.

Avvio rapido

Inizia a utilizzare qualsiasi SDK in pochi minuti:

Install the SDK

Usa il gestore di pacchetti del tuo linguaggio per installare l’SDK

TypeScript/Node.js
Python
PHP
Go
Rust

npm install dodopayments

pip install dodopayments

composer require dodopayments/client

go get github.com/dodopayments/dodopayments-go

cargo add dodopayments

Initialize the Client

Configura il client con la tua chiave API

TypeScript
Python
PHP
Go
Rust

import DodoPayments from 'dodopayments';
const client = new DodoPayments({ bearerToken: 'your_api_key' });

from dodopayments import DodoPayments
client = DodoPayments(bearer_token="your_api_key")

use Dodopayments\Client;
$client = new Client(bearerToken: 'your_api_key');

import "github.com/dodopayments/dodopayments-go"
client := dodopayments.NewClient(option.WithBearerToken("your_api_key"))

use dodopayments::Client;
let client = Client::from_env()?; // reads DODO_PAYMENTS_API_KEY

Archivia sempre le tue chiavi API in modo sicuro utilizzando variabili d’ambiente. Non inserirle mai nel sistema di controllo versione.

Make Your First API Call

Crea una sessione di checkout o un pagamento

Ora puoi elaborare i pagamenti. Visita le singole pagine degli SDK per guide ed esempi dettagliati.

Funzionalità principali

Tutti gli SDK backend condividono queste funzionalità principali. Gli SDK per il checkout mobile qui sotto sono deliberatamente più limitati: non contengono alcuna API key e non chiamano mai l’API:

Type Safety: tipizzazione forte per la sicurezza a compile-time e un migliore supporto dell’IDE
Gestione degli errori: gestione completa delle eccezioni con messaggi di errore dettagliati
Autenticazione: autenticazione semplice tramite chiave API con supporto per le variabili d’ambiente
Supporto asincrono: moderni pattern async/await quando applicabili
Impaginazione automatica: impaginazione automatica per le risposte delle liste
Fatturazione basata sull’utilizzo: supporto integrato per il monitoraggio e l’acquisizione degli eventi di utilizzo
Testing: supporto completo per un ambiente sandbox durante lo sviluppo e i test

SDK per il checkout mobile

Se preferisci aprire la pagina di checkout ospitata di Dodo invece di creare un payment sheet nativo, usa l’SDK per il checkout mobile della tua piattaforma. Tutti e quattro condividono lo stesso contratto con una sola chiamata: start(...) restituisce un CheckoutResult tipizzato, nessuno contiene una API key e Apple Pay/Google Pay funzionano allo stesso modo in cui funzionano sul web aperto, poiché il checkout si apre nella vera superficie browser della piattaforma (SFSafariViewController / Custom Tabs), non in un WebView:

Android

SDK Kotlin che apre una Chrome Custom Tab. 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

Il flusso di pagamento mobile end-to-end, dalla sessione di checkout backend alla configurazione dello schema di callback

Command-Line Interface

Per flussi di lavoro e automazioni basati sul terminale:

CLI

Interfaccia a riga di comando generata automaticamente con supporto per tutti i 78 endpoint API

Funzionalità:

Struttura dei comandi basata sulle risorse per un utilizzo intuitivo
Più formati di output (JSON, YAML, pretty, interattivo)
Completamento della shell per bash, zsh e fish
Ideale per lo scripting e l’automazione CI/CD

# Quick example
dodopayments payments list --format json | jq '.data[] | {id, amount}'

Migrazione dall’SDK Node.js

Abbiamo eseguito la migrazione dall’SDK Node.js al nuovo SDK TypeScript. Se utilizzi l’SDK Node.js legacy, consulta la guida alla migrazione per aggiornare la tua integrazione.

Adattatori per framework

Integra in meno di 10 righe di codice con i nostri adattatori per framework. Scegli tra i framework consigliati o esplora tutte le opzioni supportate.

Framework consigliati

Next.js

Framework full-stack basato su React con supporto per App Router

Better Auth

Framework per l’autenticazione con integrazioni integrate

Supabase

Alternativa open source a Firebase con Postgres e Auth

Convex

Backend-as-a-Service con funzionalità in tempo reale

Show other 8+ supported frameworks

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Ottenere assistenza

Hai bisogno di assistenza con uno degli SDK?

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 dello SDK interessato
Documentazione: Visita il nostro riferimento API

Contribuire

Accogliamo con piacere i contributi a tutti i nostri SDK! Ogni repository contiene un file CONTRIBUTING.md con le linee guida per:

Segnalare bug
Richiedere funzionalità
Inviare pull request
Eseguire test localmente
Stile e convenzioni del codice

Visita le pagine dei singoli SDK per accedere ai relativi repository GitHub e alle linee guida per i contributi.

​SDK disponibili

TypeScript SDK

Python SDK

PHP SDK

Go SDK

Ruby SDK

Java SDK

Kotlin SDK

C# SDK

Rust SDK

CLI

​Avvio rapido

​Funzionalità principali

​SDK per il checkout mobile

Android

iOS

React Native

Flutter

Mobile Integration Guide

​Command-Line Interface

CLI

​Migrazione dall’SDK Node.js

​Adattatori per framework

​Framework consigliati

Next.js

Better Auth

Supabase

Convex

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

​Ottenere assistenza

​Contribuire

SDK disponibili

Avvio rapido

Funzionalità principali

SDK per il checkout mobile

Command-Line Interface

Migrazione dall’SDK Node.js

Adattatori per framework

Framework consigliati

Ottenere assistenza

Contribuire