Step by step integrasi Azul303 untuk deposit otomatis
Panduan praktis untuk client yang ingin menghubungkan Azul303 ke website, aplikasi, bot, POS, billing, CRM, atau tools internal.
Terakhir diperbarui 23 Juli 2026
Step 1 — Login ke dashboard Azul303
URL: https://aerovault.top/login. Masuk memakai akun client. Dashboard ini hanya untuk client Azul303, bukan untuk user/customer client.
- Setelah login, buka Dashboard: https://aerovault.top/dashboard.
- Buka menu Account: https://aerovault.top/account.
- Cek nama bisnis dan email akun.
- Aktifkan 2FA sebelum membuat API key.
Step 2 — Aktifkan 2FA
URL: https://aerovault.top/account. 2FA wajib aktif supaya API key tidak dibuat dari akun yang belum aman.
- Buka Account → Security / Two-Factor Authentication.
- Scan QR 2FA memakai Google Authenticator, Authy, atau aplikasi OTP lain.
- Masukkan kode OTP untuk verifikasi.
- Setelah 2FA aktif, buka API Integration: https://aerovault.top/api-integration.
Step 3 — Generate API key dan secret
URL: https://aerovault.top/api-integration. API key dipakai untuk identitas client. API secret dipakai backend client untuk membuat HMAC signature.
- Buka menu API Integration dari sidebar dashboard client.
- Klik Generate API Key.
- Pilih environment test atau live.
- Copy API key dan API secret ke environment backend.
- Secret tetap tersedia di daftar API Keys dashboard, tetapi jangan simpan di frontend atau repository.
- Akun biasa maksimal 1 API key aktif. Premium/Investor bisa membuat banyak API key.
- Untuk contoh kode request, buka API Docs: https://aerovault.top/api/index.html.
Step 4 — Atur mode pembayaran fee
URL: https://aerovault.top/api-integration. Client bisa memilih biaya transaksi ditanggung client atau user dari setting integrasi.
- Buka bagian Payment Mode / Fee Bearer.
- Client pays: user bayar nominal order, fee transaksi mengurangi settlement client.
- User pays: user bayar nominal order + fee transaksi, settlement client tetap penuh.
- Contoh fee aktual mengikuti konfigurasi client di Azul303.
- Premium/Investor hanya dikenakan fee provider 0,7% dan tetap bisa memilih Client pays atau User pays.
Step 5 — Isi whitelist integrasi
URL: https://aerovault.top/api-integration. Whitelist dipakai sebagai lapisan keamanan tambahan. Signature tetap wajib.
- Buka bagian Domain Whitelist dan IP Whitelist.
- Domain Whitelist: isi domain website client, contoh https://client.com.
- Domain Whitelist juga dipakai untuk validasi return_url.
- IP Whitelist: isi IP server backend, bot, POS, CRM, billing, worker, atau tools internal jika IP stabil.
- Jika integrasi bukan web, gunakan IP Whitelist server yang melakukan request ke Azul303.
Step 6 — Pasang Webhook URL
URL: https://aerovault.top/api-integration. Webhook adalah jalur utama untuk menerima status final pembayaran.
- Buka API Integration → Webhook Configuration.
- Isi URL HTTPS, contoh https://client.com/webhook/Azul303.
- Pilih event payment.success dan payment.failed sesuai kebutuhan.
- Copy webhook secret dan simpan di backend client.
- Setelah test transaksi, pantau transaksi di https://aerovault.top/transactions.
Step 7 — Buat payment dari backend client
URL docs: https://aerovault.top/api/index.html. Frontend, mobile app, bot, atau tools user tidak boleh langsung memanggil API Azul303. Channel tersebut harus minta backend client membuat payment.
- Backend client kirim POST /v1/payment/create.
- Body minimum: amount.
- return_url opsional jika ingin customer kembali otomatis setelah QR page final.
- Azul303 mengembalikan payment_id, payment_url, qr_url, qr_image_url, status, fee, dan net_amount.
- Setelah payment dibuat, pantau transaksi di https://aerovault.top/transactions.
Step 8 — Pilih tampilan QR
Setting: https://aerovault.top/api-integration. Client bisa memakai hosted QR page Azul303 atau menampilkan QR image sendiri.
- Mode redirect: arahkan customer ke payment_url atau qr_url Azul303.
- Mode inline: tampilkan qr_image_url di halaman/app/bot client.
- Untuk bot Telegram/WhatsApp, kirim qr_image_url sebagai gambar atau link pembayaran.
- Jangan expose API secret ke channel user.
- Coba demo publik di https://aerovault.top/demo untuk melihat dua flow QR.
Step 9 — Proses status final
Monitoring: https://aerovault.top/transactions. Jangan menambah saldo user client saat QR dibuat. QR dibuat hanya berarti status pending.
- Jika webhook payment.success masuk dan signature valid, update saldo/order user client.
- Jika webhook gagal diterima, backend client boleh cek GET /v1/payment/status/{payment_id}.
- Pastikan update saldo bersifat idempotent agar webhook retry tidak menggandakan saldo.
- Cek wallet client di https://aerovault.top/wallet setelah settlement sukses.
Step 10 — Test sebelum live
Gunakan dashboard, docs, dan demo sebelum memakai API live: https://aerovault.top/api-integration, https://aerovault.top/api/index.html, dan https://aerovault.top/demo.
- Test create payment.
- Test redirect QR page.
- Test QR inline jika dipakai.
- Test webhook success.
- Test expired payment.
- Test return_url.
- Cek transaksi muncul di https://aerovault.top/transactions.