Kode error

Response error biasanya berbentuk:

{
  "statusCode": 401,
  "message": "IP_NOT_WHITELISTED",
  "error": "IP Address: ..."
}

Fokus pada field message untuk menentukan langkah perbaikan.

Autentikasi & akses

HTTP	`message`	Artinya	Yang bisa dilakukan
401	`API_KEY_MISSING`	Header API key kosong	Kirim `x-api-key` atau `Authorization: Bearer`
401	`INVALID_API_KEY`	Key salah / akses H2H nonaktif / akun tidak aktif	Cek API key dan status akses H2H
401	`IP_NOT_WHITELISTED`	IP pengirim belum di-whitelist	Tambahkan IP yang tercantum di `error`
429	(too many requests)	Melebihi 60 req/menit	Retry dengan backoff

HTTP	`message`	Artinya	Yang bisa dilakukan
400	`INVALID_PRODUCT`	Produk tidak ditemukan / tidak boleh lewat API	Cek `product_code` / `product_id` di katalog
400	`INSUFFICIENT_BALANCE`	Saldo tidak cukup	Top up saldo, lalu buat order baru
400	(validasi target)	ID game / data target tidak valid	Perbaiki field di `data`

Jangan retry buta pada 401 / 400 validasi — perbaiki penyebabnya dulu
Untuk timeout jaringan saat POST /orders, ulang dengan partner_ref yang sama
Log message, statusCode, dan (bila ada) IP di error
Pantau webhook sebagai sumber status final; polling GET /orders/:ref sebagai cadangan

Masih stuck? Hubungi support dengan menyertakan waktu request, partner_ref, dan cuplikan response error (tanpa membagikan API key).