Bantuan
Documentation
Integrasi REST API Malawali Payment: project, API key, order, status, dan webhook.
Malawali Payment · REST API v1
Integrasi Pembayaran QRIS
Buat order dari server Anda, tampilkan QR ke pelanggan, lalu terima callback
order.paid setelah pembayaran terdeteksi otomatis. API Key dibuat per Project
dan hanya aktif selama langganan berjalan.
Base URL
http://localhost:3001/api
Autentikasi
Header
x-api-key: pk_live_…
Format
JSON (request & response)
Webhook
HMAC-SHA256, retry maksimal 3×, timeout 10 detik
Error
Error dikembalikan dalam JSON { "error": "<code>", "message": "<penjelasan>" }.
Gunakan tabel berikut sebagai referensi penanganan.
| HTTP | Kode | Pesan |
|---|---|---|
| 400 | invalid_request |
Body atau parameter request tidak valid. |
| 400 | invalid_base_amount |
base_amount harus bilangan bulat rupiah > 0 |
| 400 | invalid_ttl |
ttl_seconds di luar rentang 60-86400 detik. |
| 400 | invalid_qris |
String QRIS tidak valid. |
| 400 | static_qris_required |
Setup QRIS harus menggunakan QRIS statis. |
| 400 | qris_provider_required |
Isi provider QRIS terlebih dahulu. |
| 401 | invalid_api_key |
API key tidak valid |
| 402 | subscription_required |
Langganan merchant tidak aktif sehingga REST API dikunci sementara. |
| 403 | live_key_required |
Endpoint hanya dapat memakai pk_live_... |
| 403 | default_project_key_required |
Endpoint pengaturan akun harus memakai API key Project Utama. |
| 404 | order_not_found |
Order tidak ditemukan untuk project ini. |
| 409 | qris_not_configured |
QRIS merchant belum diset untuk transaksi LIVE. |
| 409 | detector_not_ready |
Deteksi pembayaran belum siap untuk sumber aktif. |
| 409 | order_not_pending |
Order sudah tidak berstatus pending. |
| 503 | payment_provider_disabled |
Koneksi pembayaran terkait sedang dinonaktifkan administrator. |