Le SDK Java fournit un accès pratique et ergonomique à l’API REST de Dodo Payments pour les applications écrites en Java. Il utilise des fonctionnalités spécifiques à Java telles que Optional, Stream et CompletableFuture pour le développement Java moderne.
Installation Maven Ajoutez la dépendance à votre pom.xml :
< dependency > < groupId > com.dodopayments.api </ groupId > < artifactId > dodo-payments-java </ artifactId > < version > 1.61.5 </ version > </ dependency > Gradle Ajoutez la dépendance à votre build.gradle :
implementation ( "com.dodopayments.api:dodo-payments-java:1.61.5" ) Utilisez toujours la dernière version du SDK pour accéder aux nouvelles fonctionnalités de Dodo Payments. Consultez Maven Central pour la dernière version. Le SDK prend en charge Java 8 et toutes les versions ultérieures, y compris Java 11, 17 et 21.
Démarrage rapide Initialisez le client et créez une session de paiement :
import com.dodopayments.api.client.DodoPaymentsClient; import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient; import com.dodopayments.api.models.checkoutsessions.CheckoutSessionRequest; import com.dodopayments.api.models.checkoutsessions.CheckoutSessionResponse; // Configure using environment variables (DODO_PAYMENTS_API_KEY, DODO_PAYMENTS_BASE_URL) // Or system properties (dodopayments.apiKey, dodopayments.baseUrl) DodoPaymentsClient client = DodoPaymentsOkHttpClient . fromEnv (); CheckoutSessionRequest params = CheckoutSessionRequest . builder () . addProductCart ( CheckoutSessionRequest . ProductCart . builder () . productId ( "product_id" ) . quantity ( 1 ) . build ()) . build (); CheckoutSessionResponse checkoutSessionResponse = client . checkoutSessions (). create (params); System . out . println ( checkoutSessionResponse . sessionId ()); Stockez toujours vos clés API en toute sécurité en utilisant des variables d’environnement, des propriétés système ou un système de gestion de configuration sécurisé. Ne les intégrez jamais en dur dans votre code source.
Fonctionnalités principales
Sécurité des types API fortement typée avec sécurité à la compilation
Sûr pour les threads Sûr pour une utilisation concurrente dans des applications multi-thread
Modèle de constructeur Modèle de constructeur intuitif pour la construction de requêtes
Support asynchrone Support de CompletableFuture pour les opérations asynchrones
Configuration Variables d’environnement Configurez en utilisant des variables d’environnement ou des propriétés système :
DODO_PAYMENTS_API_KEY = your_api_key_here DODO_PAYMENTS_BASE_URL = https://live.dodopayments.com // Automatically reads from environment variables DodoPaymentsClient client = DodoPaymentsOkHttpClient . fromEnv (); Configuration manuelle Configurez manuellement avec toutes les options :
import java.time.Duration; DodoPaymentsClient client = DodoPaymentsOkHttpClient . builder () . bearerToken ( "your_api_key_here" ) . baseUrl ( "https://live.dodopayments.com" ) . maxRetries ( 4 ) . timeout ( Duration . ofSeconds ( 30 )) . responseValidation ( true ) . build (); Mode test Configurez pour l’environnement de test/sandbox :
DodoPaymentsClient testClient = DodoPaymentsOkHttpClient . builder () . fromEnv () . testMode () . build (); Opérations courantes Créer une session de paiement Générez une session de paiement :
CheckoutSessionRequest params = CheckoutSessionRequest . builder () . addProductCart ( CheckoutSessionRequest . ProductCart . builder () . productId ( "prod_123" ) . quantity ( 1 ) . build ()) . returnUrl ( "https://yourdomain.com/return" ) . build (); CheckoutSessionResponse session = client . checkoutSessions (). create (params); System . out . println ( "Checkout URL: " + session . url ()); Gérer les clients Créez et récupérez des informations sur les clients :
import com.dodopayments.api.models.customers.Customer; import com.dodopayments.api.models.customers.CustomerCreateParams; // Create a customer CustomerCreateParams createParams = CustomerCreateParams . builder () . email ( "[email protected] " ) . name ( "John Doe" ) . putMetadata ( "user_id" , "12345" ) . build (); Customer customer = client . customers (). create (createParams); // Retrieve customer Customer retrieved = client . customers (). retrieve ( "cus_123" ); System . out . println ( "Customer: " + retrieved . name () + " (" + retrieved . email () + ")" ); Gérer les abonnements Créez et gérez des abonnements récurrents :
import com.dodopayments.api.models.subscriptions. * ; // Create a subscription SubscriptionNewParams subscriptionParams = SubscriptionNewParams . builder () . customerId ( "cus_123" ) . productId ( "prod_456" ) . priceId ( "price_789" ) . build (); Subscription subscription = client . subscriptions (). create (subscriptionParams); // Charge subscription SubscriptionChargeParams chargeParams = SubscriptionChargeParams . builder () . amount ( 1000 ) . build (); SubscriptionChargeResponse chargeResponse = client . subscriptions () . charge ( subscription . id (), chargeParams); Facturation basée sur l’utilisation Créez et gérez des compteurs pour suivre l’utilisation :
import com.dodopayments.api.models.meters. * ; // Create API calls meter MeterCreateParams apiMeterParams = MeterCreateParams . builder () . name ( "API Requests" ) . eventName ( "api_request" ) . aggregation ( "count" ) . putMetadata ( "category" , "api_usage" ) . build (); Meter apiMeter = client . meters (). create (apiMeterParams); System . out . println ( "Meter created: " + apiMeter . meterId ()); // List all meters client . meters (). list () . autoPager () . forEach (m -> System . out . println ( "Meter: " + m . name () + " - " + m . aggregation ())); Ingest Events d’utilisation Suivez des événements personnalisés :
import com.dodopayments.api.models.usageevents. * ; import java.time.OffsetDateTime; // Ingest single event UsageEventIngestParams singleEventParams = UsageEventIngestParams . builder () . addEvent ( UsageEventIngestParams . Event . builder () . eventId ( "api_call_" + System . currentTimeMillis ()) . customerId ( "cus_abc123" ) . eventName ( "api_request" ) . timestamp ( OffsetDateTime . now ()) . putMetadata ( "endpoint" , "/api/v1/users" ) . putMetadata ( "method" , "GET" ) . putMetadata ( "tokens_used" , "150" ) . build ()) . build (); UsageEventIngestResponse response = client . usageEvents (). ingest (singleEventParams); System . out . println ( "Processed: " + response . processedEvents ()); Ingest Events par lot Ingest plusieurs événements efficacement (max 1000 par requête) :
UsageEventIngestParams . Builder batchBuilder = UsageEventIngestParams . builder (); for ( int i = 0 ; i < 100 ; i ++ ) { batchBuilder . addEvent ( UsageEventIngestParams . Event . builder () . eventId ( "batch_event_" + i + "_" + System . currentTimeMillis ()) . customerId ( "cus_abc123" ) . eventName ( "video_transcode" ) . timestamp ( OffsetDateTime . now (). minusMinutes (i)) . putMetadata ( "video_id" , "video_" + i) . putMetadata ( "duration_seconds" , String . valueOf ( 120 + i)) . build ()); } UsageEventIngestResponse batchResponse = client . usageEvents (). ingest ( batchBuilder . build ()); System . out . println ( "Batch processed: " + batchResponse . processedEvents () + " events" ); Gestion des erreurs Gestion complète des erreurs pour différents scénarios :
import com.dodopayments.api.errors. * ; try { Payment payment = client . payments (). retrieve ( "pay_invalid" ); } catch ( NotFoundException e ) { System . err . println ( "Payment not found: " + e . getMessage ()); } catch ( UnauthorizedException e ) { System . err . println ( "Authentication failed: " + e . getMessage ()); } catch ( PermissionDeniedException e ) { System . err . println ( "Permission denied: " + e . getMessage ()); } catch ( BadRequestException e ) { System . err . println ( "Invalid request: " + e . getMessage ()); } catch ( UnprocessableEntityException e ) { System . err . println ( "Validation error: " + e . getMessage ()); } catch ( RateLimitException e ) { System . err . println ( "Rate limit exceeded: " + e . getMessage ()); // SDK automatically retries with backoff } catch ( InternalServerException e ) { System . err . println ( "Server error: " + e . getMessage ()); } catch ( DodoPaymentsServiceException e ) { System . err . println ( "API error: " + e . statusCode () + " - " + e . getMessage ()); } Le SDK réessaie automatiquement les requêtes en cas d’erreurs de connexion, 408, 409, 429 et d’erreurs 5xx avec un backoff exponentiel.
Opérations asynchrones Utilisez CompletableFuture pour les opérations asynchrones :
import java.util.concurrent.CompletableFuture; CompletableFuture < CheckoutSessionResponse > future = client . async () . checkoutSessions () . create (params); // Handle response asynchronously future . thenAccept (response -> { System . out . println ( "Session created: " + response . sessionId ()); }). exceptionally (ex -> { System . err . println ( "Error: " + ex . getMessage ()); return null ; }); Intégration Spring Boot Classe de configuration import com.dodopayments.api.client.DodoPaymentsClient; import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @ Configuration public class DodoPaymentsConfig { @ Value ( "${dodo.api.key}" ) private String apiKey ; @ Value ( "${dodo.environment:sandbox}" ) private String environment ; @ Bean public DodoPaymentsClient dodoPayments () { return DodoPaymentsOkHttpClient . builder () . bearerToken (apiKey) . baseUrl ( environment . equals ( "live" ) ? "https://live.dodopayments.com" : "https://sandbox.dodopayments.com" ) . build (); } } Couche de service import com.dodopayments.api.client.DodoPaymentsClient; import com.dodopayments.api.models.checkoutsessions. * ; import org.springframework.stereotype.Service; @ Service public class PaymentService { private final DodoPaymentsClient client ; public PaymentService ( DodoPaymentsClient client ) { this . client = client; } public CheckoutSessionResponse createCheckout ( List < CheckoutSessionRequest . ProductCart > items ) { CheckoutSessionRequest params = CheckoutSessionRequest . builder () . productCart (items) . returnUrl ( "https://yourdomain.com/return" ) . build (); return client . checkoutSessions (). create (params); } } Ressources Support Besoin d’aide avec le SDK Java ?
Contribuer Nous accueillons les contributions ! Consultez les directives de contribution pour commencer. 
