KiPaydocs
Dokumentasi/API Reference

API REFERENCE

Response error

Gunakan status HTTP untuk mengenali kategori masalah, lalu baca field error untuk pesan diagnosis yang aman.

Referensi Diperbarui 29 Agustus 2026
01

Struktur response

Kontrak ErrorResponse saat ini memiliki satu field string bernama error.

error.json
JSON
{ "error": "Transaksi tidak ditemukan." }
02

Status HTTP

StatusKategoriStrategi
400Request atau state tidak validPerbaiki request, jangan melakukan retry tanpa kondisi
404Project atau transaksi tidak ditemukanPeriksa credential dan relasi transaksi
409Konflik saat membuat transaksiLakukan retry dengan batas yang jelas
03

Penanganan error

  • Catat trx_id dan status HTTP di log
  • Jangan mencatat API key lengkap
  • Tampilkan pesan umum kepada pelanggan
  • Batasi retry agar tidak membuat transaksi berulang
  • Pisahkan error konfigurasi dari gangguan sementara
04

Kontrak yang perlu ditambahkan

Gunakan machine-readable code pada versi API berikutnya

Field code, message, request_id, dan details akan membuat integrasi lebih stabil daripada parsing string error.