Berapa batas permintaan API SekaliPay?
Batas dihitung per API key, per endpoint, per menit: 5 untuk membuat tagihan, 2 untuk penarikan, 30 untuk cek status, dan 60 untuk endpoint baca lainnya. Lewat batas dibalas 429 RATE_LIMIT_EXCEEDED dengan header Retry-After.
Isi halaman ini dicocokkan dengan kode API per 16 Oktober 2026.
Berapa batas tiap endpoint?#
| Metode | Jalur | Fungsi | Batas per menit | Tanda tangan |
|---|---|---|---|---|
| POST | /payment | Buat tagihan | 5 | Wajib di kedua mode |
| GET | /payment/{merchant_ref_id} | Cek status | 30 | Hanya Enhanced HMAC |
| GET | /payment-methods | Daftar metode | 60 | Hanya Enhanced HMAC |
| GET | /merchant/info | Info akun | 60 | Hanya Enhanced HMAC |
| POST | /withdrawal | Penarikan | 2 | Wajib di kedua mode |
Batas sama di mode IP Whitelist dan Enhanced HMAC. Cek status dihitung bersama untuk semua merchant_ref_id, bukan per ref.
Apa yang terjadi bila batas terlampaui?#
{
"success": false,
"message": "Too many requests. Please try again later.",
"retry_after": 42,
"error_code": "RATE_LIMIT_EXCEEDED"
}Tunggu selama retry_after detik (sama dengan header Retry-After) sebelum mencoba lagi.
Header X-RateLimit-Limit dan X-RateLimit-Remaining di respons saat ini menunjukkan batas umum, bukan batas efektif tiap endpoint. Jadikan tabel di atas dan respons 429 sebagai patokan.
Bagaimana agar tidak kena batas?#
- Andalkan webhook untuk status, bukan polling.
- Simpan daftar metode di cache, jangan diambil per pembeli.
- Saat pesanan melonjak, antrekan pembuatan tagihan di server Anda dan kirim paling banyak 5 per menit per API key.
- Butuh lebih dari itu? Hubungi kami untuk membicarakan kebutuhan Anda.
Siap memakai kunci Anda sendiri?
Masuk ke dasbor merchant untuk mengambil API key dan secret key, mengatur mode akses dan URL webhook, serta mengunduh koleksi Postman berisi kunci akun Anda.
Masuk ke dasbor