Kode Error

API v1 memakai HTTP status code standar. Body error berformat sederhana — satu field error berisi pesan:

{
  "error": "amount must be between 1000 and 500000000 IDR"
}

HTTP code	Status	Deskripsi
400	Bad Request	Field wajib (order_id / amount) kosong, nominal di luar batas (Rp1.000–Rp500.000.000), atau metode pembayaran tidak tersedia / sedang maintenance.
401	Unauthorized	API key tidak valid, tidak aktif, kedaluwarsa, atau tidak disertakan di header Authorization.
403	Forbidden	Project belum Live atau disuspend (mis. mencoba transaksi produksi sebelum Go Live).
404	Not Found	Pembayaran dengan ID tersebut tidak ditemukan untuk project Anda.
409	Conflict	order_id sudah pernah dipakai di project ini — responsnya memuat payment_id transaksi yang ada. Juga dipakai saat aksi tidak bisa dijalankan pada status saat ini (mis. cancel pembayaran yang sudah paid).
429	Too Many Requests	Terlalu banyak permintaan dalam waktu singkat (mis. cek status satu pembayaran lebih dari 30 kali per menit). Tunggu sesuai header Retry-After.
500	Server Error	Kesalahan internal server. Hubungi support bila berlanjut.