Langsung ke konten utama

SDKs & Libraries

Percepat integrasi Anda dengan menggunakan SDK resmi untuk TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby, dan React Native. Perpustakaan ini menyederhanakan permintaan API, otentikasi, dan penanganan kesalahan, sehingga Anda dapat fokus membangun pengalaman pembayaran yang hebat.

​
URL Lingkungan

Pelajari lebih lanjut tentang Mode Uji vs Mode Langsung.

​
Manajemen Kunci API dan Otentikasi

1

Access API Keys

Navigasikan ke Developer → API Keys di dasbor Anda untuk mengelola kunci Anda.
2

Generate a New Key

Pilih Add API Key, berikan nama deskriptif, dan konfigurasikan akses tulis:
  • Aktifkan akses tulis (dicentang): Izin baca dan tulis penuh untuk semua operasi API
  • Aktifkan akses tulis (tidak dicentang): Akses hanya baca - hanya dapat mengambil data (pembayaran, langganan, pelanggan, produk). Tidak dapat membuat atau memodifikasi sumber daya.
Hapus centang “Enable write access” untuk integrasi dasbor, alat analitik, dan sistem mana pun yang hanya perlu melihat data tanpa membuat perubahan.
3

Store Your Key Securely

Salin kunci yang dihasilkan segera dan pastikan disimpan dengan aman.
4

Authenticate Your API Requests

Gunakan kunci API Anda untuk mengotentikasi semua permintaan. Terapkan format otorisasi berikut:
Authorization: Bearer YOUR_API_KEY
Jangan pernah mengekspos kunci API rahasia Anda di kode sisi klien atau repositori publik.

​
Format Respons

{
  "id": "pay_1234567890",
  "status": "completed",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Batasan Laju

API kami menggunakan sistem pembatasan laju dual-window dengan perlindungan lonjakan. Batas diterapkan berdasarkan metode otentikasi dan tingkat bisnis Anda.

​
Batas Default (Tier 0)

JendelaBatas
Per Detik (Lonjakan)40 permintaan
Per Menit (Berkelanjutan)240 permintaan

​
Tingkatan Bisnis

Batas laju yang lebih tinggi tersedia untuk bisnis dengan kebutuhan API yang meningkat:
TierBurst (per detik)Sustained (per menit)
Tier 0 (Default)40240
Tier 11001.000
Tier 25005.000
Hubungi dukungan untuk meningkatkan bisnis Anda ke tingkatan batas laju yang lebih tinggi.

​
Permintaan Tidak Diautentikasi

Permintaan tanpa header otentikasi yang valid dibatasi berdasarkan alamat IP:
JendelaBatas
Per Detik (Lonjakan)20 permintaan
Per Menit (Bertahap)100 permintaan

​
Header Batas Laju

Pantau penggunaan Anda dengan header respons berikut:
  • X-RateLimit-Limit - Maksimum permintaan yang diizinkan
  • X-RateLimit-Remaining - Permintaan tersisa dalam jendela saat ini
  • X-RateLimit-Reset - Waktu saat batas laju direset
Saat Anda melebihi batas laju, API mengembalikan respons 429 Too Many Requests. Terapkan backoff eksponensial dalam logika percobaan ulang Anda.

​
Penanganan Kesalahan

Untuk mengelola kesalahan secara efektif, lihat bagian Kode Kesalahan dan Kegagalan Transaksi untuk panduan terperinci.

Error Codes

Telusuri detail kesalahan yang komprehensif dan solusinya.

Transaction Failures

Dapatkan wawasan tentang masalah transaksi umum dan solusinya.

​
Webhook

Terima pemberitahuan waktu nyata tentang peristiwa pembayaran. Lihat Panduan Webhook kami untuk instruksi penyiapan.

Webhook Guide

Siapkan webhook untuk pemberitahuan waktu nyata dan penanganan peristiwa.