Referensi
Error codes
Setiap error mengembalikan error.type, error.code, pesan, dan doc_url yang mengarah ke baris di halaman ini.
400INVALID_AMOUNT
amount bukan integer rupiah.
Kirim angka bulat tanpa desimal, mis. 20000.
400AMOUNT_TOO_LOW
Nominal di bawah minimum (default Rp1.000).
Naikkan amount atau ubah batas min di pengaturan project.
400AMOUNT_TOO_HIGH
Nominal di atas maksimum (default Rp5.000.000).
Pecah pembayaran atau ubah batas max dalam rentang global.
400INVALID_PARAMETER
Parameter tidak dikenal atau formatnya salah.
Periksa error.param di respons.
400INVALID_EXPIRY
expiry_minutes di luar 5–60.
Gunakan nilai antara 5 dan 60.
400TURNSTILE_FAILED
Verifikasi anti-bot gagal.
Muat ulang halaman lalu coba lagi.
401MISSING_API_KEY
Header Authorization tidak ada.
Kirim Authorization: Bearer fq_live_… / fq_test_….
401INVALID_API_KEY
API key tidak valid.
Salin ulang key dari dashboard; key penuh hanya tampil sekali.
401API_KEY_REVOKED
API key sudah dicabut.
Buat key baru di Developer → API keys.
402SUBSCRIPTION_INACTIVE
Langganan merchant tidak aktif.
Bayar tagihan langganan; payment pending tetap dideteksi.
403INSUFFICIENT_SCOPE
API key tidak punya scope yang dibutuhkan.
Tambah scope, mis. payments:write.
403IP_NOT_ALLOWED
IP pemanggil tidak ada di allowlist key.
Tambah IP/CIDR ke allowlist.
403SOURCE_NOT_VERIFIED
QRIS source belum diverifikasi untuk live.
Selesaikan verifikasi Rp1.000 + kode unik.
404RESOURCE_NOT_FOUND
Objek tidak ditemukan.
Periksa ID dan mode (live/test).
409DUPLICATE_REFERENCE
reference_id sudah dipakai di project + mode ini.
Payment pending yang ada dikembalikan; gunakan itu.
409NO_AVAILABLE_SLOT
Semua kode unik untuk nominal ini sedang terpakai.
Coba nominal lain atau tambah QRIS source kedua.
409INVALID_STATE_TRANSITION
Aksi tidak berlaku untuk status saat ini.
Mis. cancel hanya dari pending.
409IDEMPOTENCY_KEY_REUSED
Idempotency-Key dipakai dengan body berbeda.
Pakai key baru untuk request yang berbeda.
409TOO_MANY_PENDING
Lebih dari 2.000 payment pending di project.
Batalkan payment lama atau tunggu kedaluwarsa.
422REFUND_EXCEEDS_AMOUNT
Refund melebihi sisa yang belum di-refund.
Kurangi amount refund.
429RATE_LIMITED
Terlalu banyak request.
Hormati Retry-After; SDK sudah retry otomatis.
500INTERNAL_ERROR
Kesalahan di sisi FQris.
Retry dengan Idempotency-Key yang sama.
503NO_HEALTHY_SOURCE
Tidak ada Listener sehat untuk source live.
Periksa perangkat atau set perilaku project ke allow.
503MAINTENANCE
Pemeliharaan terjadwal.
Deteksi Listener tetap berjalan; coba lagi nanti.
Apakah halaman ini membantu?