Java

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:

pom.xml

<dependency>
  <groupId>com.dodopayments.api</groupId>
  <artifactId>dodo-payments-java</artifactId>
  <version>1.97.1</version>
</dependency>

Gradle

Tambahkan dependensi ke build.gradle:

build.gradle.kts

implementation("com.dodopayments.api:dodo-payments-java:1.97.1")

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:

.env

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

Konfigurasikan untuk lingkungan Test Mode:

DodoPaymentsClient testClient = DodoPaymentsOkHttpClient.builder()
    .fromEnv()
    .testMode()
    .build();

Operasi Umum

Buat Sesi Checkout

Hasilkan sesi checkout:

CheckoutSessionRequest params = CheckoutSessionRequest.builder()
    .addProductCart(ProductItemReq.builder()
        .productId("pdt_123")
        .quantity(1)
        .build())
    .returnUrl("https://yourdomain.com/return")
    .build();

CheckoutSessionResponse session = client.checkoutSessions().create(params);
System.out.println("Checkout URL: " + session.checkoutUrl());

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:

POST /subscriptions (metode subscriptions.create dari SDK) sudah deprecated. Metode ini masih berfungsi untuk integrasi yang sudah ada, tetapi integrasi baru sebaiknya membuat subscription melalui Checkout Session.

import com.dodopayments.api.models.payments.AttachExistingCustomer;
import com.dodopayments.api.models.payments.BillingAddress;
import com.dodopayments.api.models.misc.CountryCode;
import com.dodopayments.api.models.subscriptions.SubscriptionChargeParams;
import com.dodopayments.api.models.subscriptions.SubscriptionChargeResponse;
import com.dodopayments.api.models.subscriptions.SubscriptionCreateParams;
import com.dodopayments.api.models.subscriptions.SubscriptionCreateResponse;

// Create a subscription
SubscriptionCreateParams subscriptionParams = SubscriptionCreateParams.builder()
    .billing(BillingAddress.builder()
        .city("San Francisco")
        .country(CountryCode.US)
        .state("CA")
        .street("1 Market St")
        .zipcode("94105")
        .build())
    .customer(AttachExistingCustomer.builder()
        .customerId("cus_123")
        .build())
    .productId("pdt_456")
    .quantity(1)
    .paymentLink(true)
    .returnUrl("https://yourdomain.com/return")
    .build();

SubscriptionCreateResponse subscription = client.subscriptions().create(subscriptionParams);
System.out.println("Subscription ID: " + subscription.subscriptionId());

// Charge an on-demand subscription
// product_price is in the lowest currency denomination (e.g., 2500 = $25.00 USD)
SubscriptionChargeParams chargeParams = SubscriptionChargeParams.builder()
    .subscriptionId(subscription.subscriptionId())
    .productPrice(2500)
    .build();

SubscriptionChargeResponse chargeResponse = client.subscriptions().charge(chargeParams);
System.out.println("Payment ID: " + chargeResponse.paymentId());

productPrice dinyatakan dalam denominasi mata uang terendah (misalnya, sen untuk USD, paise untuk INR). Untuk menagih $25.00, masukkan 2500.

Penagihan melalui subscriptions().charge(...) ditujukan untuk subscription on-demand. Subscription terjadwal standar ditagih secara otomatis berdasarkan jadwal harga produk.

Penagihan Berbasis Penggunaan

Konfigurasikan 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(MeterAggregation.builder()
        .type(MeterAggregation.Type.COUNT)
        .build())
    .measurementUnit("calls")
    .build();

Meter apiMeter = client.meters().create(apiMeterParams);
System.out.println("Meter created: " + apiMeter.id());

// List all meters
client.meters().list()
    .autoPager()
    .forEach(m -> System.out.println("Meter: " + m.name() + " - " + m.aggregation()));

Masukkan Event Penggunaan

Lacak event kustom:

import com.dodopayments.api.models.usageevents.EventInput;
import com.dodopayments.api.models.usageevents.*;
import java.time.OffsetDateTime;

// Ingest single event
UsageEventIngestParams singleEventParams = UsageEventIngestParams.builder()
    .addEvent(EventInput.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.ingestedCount());

Masukkan Event Secara Batch

Masukkan beberapa event secara efisien (maks. 1000 per request):

UsageEventIngestParams.Builder batchBuilder = UsageEventIngestParams.builder();

for (int i = 0; i < 100; i++) {
    batchBuilder.addEvent(EventInput.builder()
        .eventId("batch_event_" + i + "_" + System.currentTimeMillis())
        .customerId("cus_abc123")
        .eventName("video_transcode")
        .timestamp(OffsetDateTime.now().minusSeconds(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.ingestedCount() + " events");

Penanganan Error

Penanganan error 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 kembali request saat terjadi connection error, error 408, 409, 429, dan 5xx dengan exponential backoff.

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

Class 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:test}")
    private String environment;
    
    @Bean
    public DodoPaymentsClient dodoPayments() {
        return DodoPaymentsOkHttpClient.builder()
            .bearerToken(apiKey)
            .baseUrl(environment.equals("live") 
                ? "https://live.dodopayments.com" 
                : "https://test.dodopayments.com")
            .build();
    }
}

Service Layer

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);
    }
}

Resources

GitHub Repository

Lihat source code dan berkontribusilah

API Reference

Dokumentasi API lengkap

Discord Community

Dapatkan bantuan dan terhubung dengan developer

Report Issues

Laporkan bug atau minta fitur

Dukungan

Perlu bantuan dengan Java SDK?

Discord: Bergabunglah dengan server komunitas kami untuk mendapatkan dukungan secara real-time
Email: Hubungi kami di support@dodopayments.com
GitHub: Buat issue di repository

Berkontribusi

Kami menyambut kontribusi! Lihat panduan kontribusi untuk memulai.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Instalasi

Maven

Gradle

Memulai Cepat

Fitur Utama

Type Safety

Thread-Safe

Builder Pattern

Async Support

Konfigurasi

Variabel Lingkungan

Konfigurasi Manual

Mode Uji

Operasi Umum

Buat Sesi Checkout

Kelola Pelanggan

Tangani Langganan

Penagihan Berbasis Penggunaan

Konfigurasikan Meter

Masukkan Event Penggunaan

Masukkan Event Secara Batch

Penanganan Error

Operasi Asinkron

Integrasi Spring Boot

Class Konfigurasi

Service Layer

Resources

GitHub Repository

API Reference

Discord Community

Report Issues

Dukungan

Berkontribusi

​Instalasi

​Maven

​Gradle

​Memulai Cepat

​Fitur Utama

Type Safety

Thread-Safe

Builder Pattern

Async Support

​Konfigurasi

​Variabel Lingkungan

​Konfigurasi Manual

​Mode Uji

​Operasi Umum

​Buat Sesi Checkout

​Kelola Pelanggan

​Tangani Langganan

​Penagihan Berbasis Penggunaan

​Konfigurasikan Meter

​Masukkan Event Penggunaan

​Masukkan Event Secara Batch

​Penanganan Error

​Operasi Asinkron

​Integrasi Spring Boot

​Class Konfigurasi

​Service Layer

​Resources

GitHub Repository

API Reference

Discord Community

Report Issues

​Dukungan

​Berkontribusi

Instalasi

Maven

Gradle

Memulai Cepat

Fitur Utama

Konfigurasi

Variabel Lingkungan

Konfigurasi Manual

Mode Uji

Operasi Umum

Buat Sesi Checkout

Kelola Pelanggan

Tangani Langganan

Penagihan Berbasis Penggunaan

Konfigurasikan Meter

Masukkan Event Penggunaan

Masukkan Event Secara Batch

Penanganan Error

Operasi Asinkron

Integrasi Spring Boot

Class Konfigurasi

Service Layer

Resources

Dukungan

Berkontribusi