Errors
The API returns JSON { "error": "..." } with the corresponding HTTP status.
Common
| HTTP | Typical meaning |
|---|---|
400 | Validation / invalid request / Credit or quota |
401 | Missing or invalid API key / JWT |
404 | Resource not found |
409 | Conflict (e.g. payment settle) |
413 | Media upload > 16 MB |
429 | Rate limit |
500 | Internal error |
Billing
Example messages:
Kuota pesan paket … sudah habis. Naikkan paket untuk lanjut kirim.kuota Sandbox (… pesan/bulan) sudah habisidentity verification required before sending to production numbers
Fair-use gating uses FAIR_USE_ENFORCE. Messaging W-Coin debit is off in the Tech Provider model (MESSAGING_WALLET_ENABLED=false).
Webhook forward
If a forward URL is rejected: ensure HTTPS and that the host does not resolve to a private IP (see Webhooks).