Error Response Codes

API mengembalikan code standar. Cabangkan logic berdasarkan code — jangan hanya mengandalkan teks message.

Kode respons standar

code	Arti	Yang perlu dilakukan
00	Sukses	Update order lokal; beri tahu user; audit log
01	Diproses	Poll dengan inquiry; set timeout
10	Bad request	Perbaiki field wajib, tipe, bentuk request
11	Not found	Cek endpoint, orderNo / tradeNo, versi API
12	Unauthorized	Cek signature, key, payment method → Aturan Signature
13	Too many requests	Turunkan rate; exponential backoff
14	Forbidden	Cek status akun / metode; hubungi BD
15	Timeout	Cek jaringan; retry dengan delay naik
16	Saldo tidak cukup	Validasi saldo sebelum pay-out; pesan jelas ke user
99	Sistem / channel	Log respons + requestId; retry singkat, lalu support

Contoh response body

{
  "code": "10",
  "message": "Bad Request",
  "details": "Missing required parameter: merchantId",
  "timestamp": "2020-12-17T10:55:00-05:00",
  "requestId": "req_123456789"
}

Catatan implementasi

1. Cabang berdasarkan code — teks bisa berubah; kode stabil.
2. Retry hanya jika aman — 01 / 15 / sebagian 99; perbaiki 10–14 dan 16 dulu.
3. Logging — minimal code, requestId, dan order id Anda.
4. Idempotent — retry / callback berulang tidak boleh double-credit.

Playbook support untuk code + responseCode: Customer RAG.