SDK Java menyediakan akses yang nyaman dan ergonomis ke Dodo Payments REST API untuk aplikasi yang ditulis dalam Java. Ini memanfaatkan fitur spesifik Java seperti Optional, Stream, dan CompletableFuture untuk pengembangan Java modern.
Instalasi Maven Tambahkan dependensi ke pom.xml:
< dependency > < groupId > com.dodopayments.api </ groupId > < artifactId > dodo-payments-java </ artifactId > < version > 1.86.3 </ version > </ dependency >
Gradle Tambahkan dependensi ke build.gradle:
implementation ( "com.dodopayments.api:dodo-payments-java:1.86.3" )
Selalu gunakan versi SDK terbaru untuk mengakses fitur Dodo Payments terkini. Periksa Maven Central untuk versi terbaru. SDK ini mendukung Java 8 dan semua versi selanjutnya, termasuk Java 11, 17, dan 21.
Memulai Cepat Inisialisasi klien dan buat sesi checkout:
import com.dodopayments.api.client.DodoPaymentsClient; import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient; import com.dodopayments.api.models.checkoutsessions.CheckoutSessionCreateParams; import com.dodopayments.api.models.checkoutsessions.CheckoutSessionRequest; import com.dodopayments.api.models.checkoutsessions.ProductItemReq; // 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 ( ProductItemReq . builder () . productId ( "product_id" ) . quantity ( 1 ) . build ()) . build (); CheckoutSessionResponse checkoutSessionResponse = client . checkoutSessions (). create (params); System . out . println ( checkoutSessionResponse . sessionId ());
Selalu simpan kunci API Anda secara aman menggunakan variabel lingkungan, properti sistem, atau sistem manajemen konfigurasi yang aman. Jangan pernah menyimpannya secara langsung di kode sumber Anda.
Fitur Utama
Type Safety API dengan tipe kuat yang memiliki keamanan waktu kompilasi
Thread-Safe Aman untuk digunakan secara bersamaan dalam aplikasi multi-threaded
Builder Pattern Pola builder intuitif untuk menyusun permintaan
Async Support Dukungan CompletableFuture untuk operasi asinkron
Konfigurasi Variabel Lingkungan Konfigurasi menggunakan variabel lingkungan atau properti sistem:
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 ();
Konfigurasi Manual Konfigurasi secara manual dengan semua opsi:
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 Uji Konfigurasi untuk lingkungan uji/sandbox:
DodoPaymentsClient testClient = DodoPaymentsOkHttpClient . builder () . fromEnv () . testMode () . build ();
Operasi Umum Buat Sesi Checkout Hasilkan sesi checkout:
CheckoutSessionRequest params = CheckoutSessionRequest . builder () . addProductCart ( ProductItemReq . 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 ());
Kelola Pelanggan Buat dan ambil informasi pelanggan:
import com.dodopayments.api.models.customers.Customer; import com.dodopayments.api.models.customers.CustomerCreateParams; // Create a customer CustomerCreateParams createParams = CustomerCreateParams . builder () . email ( "customer@example.com" ) . 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 () + ")" );
Tangani Langganan Buat dan kelola langganan berulang:
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);
Penagihan Berdasarkan Penggunaan Konfigurasi Meter Buat dan kelola meter untuk melacak penggunaan:
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 ()));
Masukkan Peristiwa Penggunaan Lacak peristiwa kustom:
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 ());
Masukkan Peristiwa Secara Batch Masukkan beberapa peristiwa secara efisien (maks 1000 per permintaan):
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" );
Penanganan Kesalahan Penanganan kesalahan yang komprehensif untuk berbagai skenario:
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 ()); }
SDK secara otomatis mencoba ulang permintaan ketika terjadi kesalahan koneksi, 408, 409, 429, dan kesalahan 5xx dengan backoff eksponensial.
Operasi Asinkron Gunakan CompletableFuture untuk operasi asinkron:
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 ; });
Integrasi Spring Boot Kelas Konfigurasi 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 (); } }
Lapisan Layanan 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 < ProductItemReq > items ) { CheckoutSessionRequest params = CheckoutSessionRequest . builder () . productCart (items) . returnUrl ( "https://yourdomain.com/return" ) . build (); return client . checkoutSessions (). create (params); } }
Sumber Daya Dukungan Butuh bantuan dengan SDK Java?
Kontribusi Kami menyambut kontribusi! Periksa pedoman kontribusi untuk memulai. 
