Pendahuluan - Dodo Payments Documentation

SDKs & Libraries

SDK backend resmi untuk TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby, dan Rust. Library ini menyederhanakan permintaan API, autentikasi, dan penanganan error, sehingga Anda dapat fokus membangun pengalaman pembayaran yang luar biasa.

Mobile Checkout SDKs

Sedang membangun aplikasi native? Buka hosted checkout milik Dodo dan dapatkan hasil bertipe dalam satu panggilan, di Android, iOS, React Native, dan Flutter. Ini tidak menyimpan API key.

URL Environment

Test Mode: https://test.dodopayments.com
Live Mode: https://live.dodopayments.com

Pelajari lebih lanjut tentang Test Mode vs Live Mode.

Pengelolaan API Key dan Autentikasi

Access API Keys

Buka Developer → API Keys di dashboard Anda untuk mengelola key.

Generate a New Key

Pilih Add API Key, berikan nama yang deskriptif, dan konfigurasikan akses tulis:

Enable write access (dicentang): Izin baca dan tulis penuh untuk semua operasi API
Enable write access (tidak dicentang): Akses hanya baca - hanya dapat mengambil data (pembayaran, subscription, customer, produk). Tidak dapat membuat atau mengubah resource.

Hapus centang “Enable write access” untuk integrasi dashboard, alat analitik, dan sistem apa pun yang hanya perlu melihat data tanpa melakukan perubahan.

Store Your Key Securely

Salin key yang dibuat segera dan pastikan key tersebut disimpan dengan aman.

Authenticate Your API Requests

Gunakan API key Anda untuk mengautentikasi semua request. Terapkan format authorization berikut:

Authorization: Bearer YOUR_API_KEY

Jangan pernah mengekspos secret API key Anda dalam kode sisi klien atau repository publik.

Format Response

{
  "payment_id": "pay_gr4RizvMOXFJ6xca3y2tU",
  "status": "succeeded",
  "total_amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

{
  "code": "INVALID_REQUEST",
  "message": "The request contains invalid parameters"
}

Rate Limit

API kami menggunakan sistem rate limiting dengan dua jendela dan perlindungan burst. Limit diterapkan berdasarkan metode autentikasi dan tier bisnis Anda.

Limit Default (Tier 0)

Jendela	Limit
Per Detik (Burst)	40 request
Per Menit (Berkelanjutan)	240 request

Tier Bisnis

Rate limit yang lebih tinggi tersedia untuk bisnis dengan kebutuhan API yang lebih besar:

Tier	Burst (per detik)	Berkelanjutan (per menit)
Tier 0 (Default)	40	240
Tier 1	100	1.000
Tier 2	500	5.000

Hubungi support untuk meningkatkan bisnis Anda ke tier rate limit yang lebih tinggi.

Request Tanpa Autentikasi

Request tanpa header autentikasi yang valid dibatasi berdasarkan alamat IP:

Jendela	Limit
Per Detik (Burst)	20 request
Per Menit (Berkelanjutan)	100 request

Header Rate Limit

Pantau penggunaan Anda dengan response header berikut:

X-RateLimit-Limit - Jumlah maksimum request yang diizinkan
X-RateLimit-Remaining - Jumlah request yang tersisa pada jendela saat ini
X-RateLimit-Reset - Waktu saat rate limit direset

Saat Anda melampaui rate limit, API mengembalikan response 429 Too Many Requests. Terapkan exponential backoff dalam logika retry Anda.

Penanganan Error

Untuk mengelola error secara efektif, lihat bagian Error Codes dan Transaction Failures untuk panduan terperinci.

Error Codes

Pelajari detail error yang komprehensif dan solusinya.

Transaction Failures

Dapatkan wawasan tentang masalah transaksi umum dan solusinya.

Webhooks

Terima notifikasi real-time tentang event pembayaran. Lihat Webhook Guide kami untuk petunjuk penyiapan.

Webhook Guide

Siapkan webhooks untuk notifikasi real-time dan penanganan event.

Panduan Developer Terkait

Jelajahi panduan komprehensif kami untuk memahami cara mengimplementasikan fitur-fitur utama menggunakan API:

One-time Payments Integration

Pelajari cara mengintegrasikan pembayaran satu kali, checkout session, dan payment link ke dalam aplikasi Anda

Subscription Integration

Panduan lengkap untuk mengimplementasikan subscription, mengelola plan, dan menangani event dalam siklus subscription

Usage-Based Billing

Siapkan meter dan event penggunaan untuk metered billing dan model penetapan harga berbasis konsumsi

Webhooks

Terima notifikasi real-time dan otomatisasikan workflow dengan event webhook

Checkout Sessions

Buat pengalaman hosted checkout yang aman dengan kustomisasi penuh dan fitur lanjutan

SDKs & Libraries

Mobile Checkout SDKs

​URL Environment

​Pengelolaan API Key dan Autentikasi

​Format Response

​Rate Limit

​Limit Default (Tier 0)

​Tier Bisnis

​Request Tanpa Autentikasi

​Header Rate Limit

​Penanganan Error

Error Codes

Transaction Failures

​Webhooks

Webhook Guide

​Panduan Developer Terkait

One-time Payments Integration

Subscription Integration

Usage-Based Billing

Webhooks

Checkout Sessions

URL Environment

Pengelolaan API Key dan Autentikasi

Format Response

Rate Limit

Limit Default (Tier 0)

Tier Bisnis

Request Tanpa Autentikasi

Header Rate Limit

Penanganan Error

Webhooks

Panduan Developer Terkait