API reference
Error codes
The Payment API error shape, the meaning of each code, and the recommended action.
In short: every error is {"error":"<message>"}. For 5xx answers and timeouts, always retry with the same Idempotency-Key and body so that no duplicate payment is created. For 429, wait for the number of seconds in Retry-After.
§11 Kode error#
Semua error berbentuk {"error":"<pesan>"}.
| HTTP | error |
Arti dan tindakan |
|---|---|---|
| 400 | missing Idempotency-Key |
tambahkan header |
| 400 | invalid request body |
JSON tidak valid atau ada field tak dikenal |
| 400 | invalid payment request |
nilai tidak valid (mis. currency bukan IDR, metode tidak dikenal). Bisa disertai "fields": {"amount": "…"} |
| 400 | minimum amount for VIRTUAL_ACCOUNT is IDR 10000 |
nominal di bawah minimum metode |
| 400 | payment method is disabled or unavailable for this checkout mode |
metode tidak aktif untuk project; cek /v1/integration-context |
| 401 | unauthorized |
API key salah, dicabut, atau tidak dikirim |
| 403 | merchant is suspended |
merchant nonaktif; hubungi tim AKD |
| 404 | payment or project not found |
project_id atau payment_id bukan milik merchant Anda |
| 409 | idempotency key conflicts with an existing payment |
key dipakai ulang dengan body berbeda |
| 409 | external_order_id is already used by another payment in this project |
external_order_id sudah dipakai pembayaran lain di project yang sama (dengan Idempotency-Key berbeda) |
| 409 | payment is not simulatable |
simulasi hanya untuk pembayaran PENDING di sandbox |
| 429 | rate limit exceeded |
tunggu sesuai header Retry-After (detik) |
| 500 | internal server error |
ulangi dengan Idempotency-Key yang sama; bila berulang, hubungi tim AKD |
| 502 | payment provider unavailable |
provider sedang bermasalah; ulangi dengan key yang sama setelah jeda |
Untuk 5xx dan timeout, selalu ulangi dengan Idempotency-Key dan body yang sama supaya tidak tercipta pembayaran ganda.