Vue d’ensemble des SDK officiels - Dodo Payments Documentation

Dodo Payments fournit des SDK officiels pour plusieurs langages de programmation. Chacun est conçu selon les bonnes pratiques propres à son langage et avec des fonctionnalités modernes, pour une intégration fluide des paiements.

Utilisez toujours la dernière version du SDK pour bénéficier des fonctionnalités et améliorations les plus récentes. Consultez régulièrement votre gestionnaire de paquets pour vérifier les mises à jour et vous assurer d’avoir accès à toutes les capacités de Dodo Payments.

SDK disponibles

Choisissez le SDK correspondant à votre stack technique :

TypeScript SDK

Intégration type-safe pour TypeScript et Node.js avec une API basée sur les promises et la pagination automatique

Python SDK

Interface idiomatique pour Python avec prise en charge d’async/await dans les applications Python 3.7+

PHP SDK

SDK conforme à PSR-4 pour les applications PHP 8.1+ modernes

Go SDK

Interface Go idiomatique avec prise en charge du contexte et typage fort

Ruby SDK

Interface Ruby élégante respectant les conventions et bonnes pratiques de Ruby

Java SDK

SDK robuste et thread-safe pour Java 8+, avec prise en charge de Maven et Gradle

Kotlin SDK

SDK Kotlin moderne avec coroutines, sécurité contre les valeurs nulles et fonctions d’extension

C# SDK

SDK type-safe pour .NET 8+ avec API basée sur des tâches async (Beta)

Rust SDK

SDK conçu autour de l’async, basé sur Tokio et reqwest, avec typage fort pour Rust 1.75+

CLI

Interface de ligne de commande pour interagir avec l’API depuis votre terminal

Vous développez une application mobile ? Consultez les SDK de paiement mobile ci-dessous pour Android, iOS, React Native et Flutter.

Démarrage rapide

Commencez à utiliser n’importe quel SDK en quelques minutes :

Install the SDK

Utilisez le gestionnaire de paquets de votre langage pour installer le 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

Configurez le client avec votre clé 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

Stockez toujours vos clés API de manière sécurisée à l’aide de variables d’environnement. Ne les envoyez jamais dans le contrôle de version.

Make Your First API Call

Créez une session de checkout ou un paiement

Vous êtes maintenant prêt à traiter les paiements ! Consultez les pages consacrées à chaque SDK pour découvrir des guides et exemples détaillés.

Fonctionnalités clés

Tous les SDK backend partagent ces fonctionnalités principales. Les SDK de paiement mobile ci-dessous sont volontairement plus limités — ils ne contiennent aucune clé API et n’appellent jamais l’API :

Type Safety : typage fort pour garantir la sécurité à la compilation et améliorer la prise en charge par les IDE
Gestion des erreurs : gestion complète des exceptions avec des messages d’erreur détaillés
Authentification : authentification simple par clé API avec prise en charge des variables d’environnement
Prise en charge de l’async : modèles async/await modernes lorsque cela est applicable
Pagination automatique : pagination automatique des réponses de type liste
Facturation basée sur l’utilisation : prise en charge intégrée du suivi et de l’ingestion des événements d’utilisation
Tests : prise en charge complète de l’environnement sandbox pour le développement et les tests

SDK de paiement mobile

Si vous préférez ouvrir la page de paiement hébergée de Dodo plutôt que de créer une feuille de paiement native, utilisez le SDK de paiement mobile adapté à votre plateforme. Les quatre SDK partagent le même contrat en un seul appel : start(...) renvoie un CheckoutResult typé, aucun ne contient de clé API, et Apple Pay/Google Pay fonctionnent de la même manière que sur le web ouvert, puisque le paiement s’ouvre dans la véritable interface de navigateur de la plateforme (SFSafariViewController / Custom Tabs), et non dans un WebView :

Android

SDK Kotlin qui ouvre un onglet personnalisé Chrome. Nécessite minSdk 23

iOS

SDK Swift qui ouvre SFSafariViewController. Nécessite iOS 16+

React Native

Turbo Module basé sur les deux cœurs natifs. Nécessite React Native 0.76+

Flutter

Canal Pigeon basé sur les deux cœurs natifs. Nécessite Flutter 3.44+

Mobile Integration Guide

Le flux de paiement mobile de bout en bout, de la session de paiement backend à la configuration du schéma de callback

Interface de ligne de commande

Pour les workflows et l’automatisation basés sur un terminal :

CLI

Interface de ligne de commande générée automatiquement, avec prise en charge des 78 endpoints API

Fonctionnalités :

Structure de commandes basée sur les ressources pour une utilisation intuitive
Plusieurs formats de sortie (JSON, YAML, lisible, interactif)
Complétion shell pour bash, zsh et fish
Idéale pour les scripts et l’automatisation CI/CD

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

Migration depuis le SDK Node.js

Nous avons migré du SDK Node.js vers le nouveau SDK TypeScript. Si vous utilisez l’ancien SDK Node.js, consultez le guide de migration pour mettre à jour votre intégration.

Adaptateurs de framework

Intégrez notre solution en moins de 10 lignes de code grâce à nos adaptateurs de framework. Choisissez parmi nos frameworks recommandés ou explorez toutes les options prises en charge.

Frameworks recommandés

Next.js

Framework full-stack basé sur React, avec prise en charge de l’App Router

Better Auth

Framework d’authentification avec intégrations intégrées

Supabase

Alternative open source à Firebase avec Postgres et Auth

Convex

Backend-as-a-Service avec des fonctionnalités en temps réel

Show other 8+ supported frameworks

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Obtenir de l’aide

Besoin d’aide avec un SDK ?

Discord : rejoignez notre serveur communautaire pour obtenir de l’aide en temps réel
E-mail : contactez-nous à l’adresse support@dodopayments.com
GitHub : ouvrez une issue dans le dépôt du SDK concerné
Documentation : consultez notre référence API

Contribuer

Nous accueillons les contributions à tous nos SDK ! Chaque dépôt contient un fichier CONTRIBUTING.md présentant les consignes pour :

Signaler des bugs
Demander des fonctionnalités
Soumettre des pull requests
Exécuter les tests en local
Respecter le style et les conventions de code

Consultez les pages des différents SDK pour accéder à leurs dépôts GitHub et à leurs consignes de contribution.

​SDK disponibles

TypeScript SDK

Python SDK

PHP SDK

Go SDK

Ruby SDK

Java SDK

Kotlin SDK

C# SDK

Rust SDK

CLI

​Démarrage rapide

​Fonctionnalités clés

​SDK de paiement mobile

Android

iOS

React Native

Flutter

Mobile Integration Guide

​Interface de ligne de commande

CLI

​Migration depuis le SDK Node.js

​Adaptateurs de framework

​Frameworks recommandés

Next.js

Better Auth

Supabase

Convex

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

​Obtenir de l’aide

​Contribuer

SDK disponibles

Démarrage rapide

Fonctionnalités clés

SDK de paiement mobile

Interface de ligne de commande

Migration depuis le SDK Node.js

Adaptateurs de framework

Frameworks recommandés

Obtenir de l’aide

Contribuer