Batas permintaan

Batas permintaan dihitung per merchant, memakai jendela satu menit.

Nilai bawaan dapat diubah operator Paymenku. Jangan menanamkannya di dalam kode — baca dari header respons.

Header pada setiap responsCopy Anchor Link

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1793067181

Saat batas terlampauiCopy Anchor Link

Respons 429 beserta header Retry-After:

{
  "status": "error",
  "message": "Rate limit exceeded. Please retry after 42 seconds."
}

Cara menanganinyaCopy Anchor Link

• Hormati Retry-After. Mencoba ulang lebih cepat hanya memperpanjang blokir.
• Pakai backoff eksponensial dengan sedikit jitter, bukan interval tetap.
• Jangan polling status. Satu webhook menggantikan ribuan panggilan check-status.
• Rem dari sisi klien ketika X-RateLimit-Remaining mulai menipis.
• Antrikan tugas massal daripada mengirimnya serentak.

Contoh backoffCopy Anchor Link

async function callWithRetry(fn, maxAttempts = 4) {
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const res = await fn();
    if (res.status !== 429) return res;

    const retryAfter = Number(res.headers.get('Retry-After') ?? 2 ** attempt);
    const jitter = Math.random() * 250;
    await new Promise((r) => setTimeout(r, retryAfter * 1000 + jitter));
  }
  throw new Error('Rate limit: percobaan habis');
}