Error Codes

Jika request gagal, API mengembalikan object error.

{
  "error": {
    "code": "invalid_api_key",
    "message": "secret key is invalid or revoked"
  }
}

Public API

HTTP	Code	Keterangan
`400`	`invalid_json`	Body bukan JSON valid.
`400`	`invalid_amount`	Nominal tidak valid.
`400`	`invalid_bulk_size`	Jumlah item bulk tidak valid.
`400`	`unsupported_payment_method`	Payment method tidak didukung.
`400`	`payment_create_failed`	Transaksi gagal dibuat.
`400`	`payment_cancel_failed`	Transaksi gagal dibatalkan.
`400`	`payment_refund_failed`	Transaksi gagal direfund.
`401`	`invalid_api_key`	Secret key kosong, tidak valid, atau sudah di-revoke.
`403`	`merchant_not_approved`	Merchant belum aktif.
`403`	`api_key_ip_not_allowed`	IP request tidak ada di allowlist API key.
`404`	`not_found`	Resource tidak ditemukan.
`429`	`rate_limited`	Rate limit terlampaui.
`500`	`server_error`	Request gagal diproses.

API menerapkan rate limit untuk menjaga layanan tetap stabil. Jika mendapat 429, tunggu sebentar sebelum mengirim request berikutnya.

Kondisi	Retry
Timeout	Ya, gunakan request yang sama.
`500`	Ya, setelah jeda.
`400`, `401`, `403`, `404`	Tidak. Perbaiki request atau status merchant.
`429`	Ya, setelah jeda sampai window rate limit berikutnya.