Error Codes

Daftar kode error yang mungkin dikembalikan oleh API.

vpn_key Authentication Errors (401)

Code	Description
INVALID_API_KEY	API Key tidak valid atau tidak ditemukan.
ACCOUNT_MUST_BE_RESELLER	Akun harus memiliki role reseller.
INVALID_IP	IP address tidak terdaftar di whitelist.

block Forbidden Errors (403)

Code	Description
THE_ACCOUNT_HAS_BEEN_SUSPENDED	Akun telah di-suspend.

warning Validation Errors (400/422)

Code	Description
BALANCE_IS_INSUFFICIENT	Saldo tidak mencukupi untuk transaksi.
REF_ID_ALREADY_EXIST	ref_id sudah pernah digunakan.
ITEM_NOT_FOUND	Item tidak ditemukan.
OUT_OF_STOCK	Stok item habis.
REQUIRED_FIELD_MISSING	Field wajib produk tidak dikirim — mis. `note` (User ID / target), `zone_id` (server/zona), atau `provider_qty` (nominal open denom). Response menyertakan `error` (penjelasan) dan `field` (lokasi field, mis. `carts.0.note`).

cloud_off Service Availability (503)

Bila produk sedang tidak dapat diproses saat ini, order ditolak di depan dan saldo Anda tidak dipotong. Cukup ulangi order beberapa saat lagi.

Code	HTTP	Description
PRODUCT_TEMPORARILY_UNAVAILABLE	503	Produk sedang tidak tersedia untuk saat ini. Order ditolak & saldo Anda tidak terpotong. Silakan coba lagi nanti.

search_off Not Found Errors (404)

Code	Description
TRANSACTION_NOT_FOUND	Transaksi tidak ditemukan.
ITEM_NOT_FOUND	Item tidak ditemukan.

Error Response Format

ERROR RESPONSE

{
                  "message": "ERROR_CODE",
                  "errors": {
                    "field_name": [
                      "Error description"
                    ]
                  }
                }

info

Tip: Selalu cek field message untuk menentukan jenis error dan handle sesuai kebutuhan aplikasi Anda.