Azul303 client guide

Panduan Client Azul303 — Integrasi Payment Gateway API

Ringkasan cara kerja Azul303 untuk fee, penarikan dana, QR payment, webhook, settlement, API key, dan ledger wallet.

Azul303 Premium & Investor

Premium tersedia Rp200.000/bulan dan dibayar melalui QR Azul303 ke merchant Azul303 - PGA.
Investor tersedia Rp1.000.000 sekali bayar dan benefit aktif lifetime tanpa langganan lagi.
Akun Premium/Investor mendapat centang biru verified di dashboard client dan halaman QR payment.
Akun Premium/Investor mendapat fee payment hanya biaya 0,7%, tetap bisa memilih biaya ditanggung client/user, dan withdraw diproses otomatis tanpa approve admin.
Akun Premium/Investor bisa membuat banyak API key, banyak webhook URL, banyak domain whitelist, dan banyak IP whitelist.
Akun biasa dibatasi 1 API key aktif, 1 webhook URL aktif, 1 domain whitelist, dan 1 IP whitelist.
Status Premium/Investor menjadi highlight trust untuk merchant saat customer melihat halaman pembayaran Azul303.
Masa aktif premium berjalan 1 bulan sejak pembayaran berhasil. Renew akan menambah masa aktif berikutnya.
Upgrade Premium, renew Premium, dan pembelian Investor dilakukan dari menu Account di aerovault.top.

Fee transaksi dihitung otomatis dari 0,7% nominal + biaya layanan Azul303 Rp500–Rp700.
Untuk akun Premium/Investor, biaya layanan Azul303 menjadi 0 sehingga fee payment hanya 0,7%.
Fee dapat ditanggung client atau user sesuai setting Payment Mode di dashboard client.
Client pays: user membayar nominal order, fee mengurangi settlement client.
User pays: user membayar nominal order + fee, settlement client tetap penuh.

Minimal withdraw saat ini Rp10.000.
Maksimal withdraw per transaksi Rp20.000.000.
Biaya withdraw Azul303 ditampilkan sebelum submit.
Mode withdraw di /api-integration: Diterima utuh berarti e-wallet menerima nominal request dan wallet debit nominal + fee. Diterima bersih berarti wallet debit nominal request dan e-wallet menerima nominal - fee.
Withdraw hanya tersedia ke e-wallet terverifikasi: DANA, GoPay, OVO, dan LinkAja.
ShopeePay sedang nonaktif. Rekening bank masih coming soon.
Jika pencairan gagal, saldo dikembalikan ke wallet client melalui ledger rollback.

Saldo client tidak diubah langsung tanpa catatan ledger.
Deposit success akan menambah saldo wallet sesuai net settlement.
Withdraw, fee, adjustment, refund, dan rollback tercatat sebagai ledger movement.
Client dapat mengunduh statement wallet dan report transaksi dari dashboard.

Client dapat memakai hosted QR page Azul303 atau embedded QR image.
Hosted mode mengarahkan customer ke halaman QR Azul303.
Embedded mode menampilkan QR image di aplikasi, bot, POS, atau tools client sendiri.
QR memiliki masa expired sesuai konfigurasi Azul303.

Azul303 mengirim webhook untuk event payment dan withdraw.
Client wajib memverifikasi signature webhook sebelum update order/saldo internal.
Webhook success menjadi bukti final yang direkomendasikan untuk settlement di sistem client.
Jika webhook gagal, Azul303 melakukan retry sesuai konfigurasi.

API key dan API secret hanya boleh disimpan di backend/server client.
Request API memakai signature HMAC SHA256.
2FA wajib aktif sebelum client generate API key baru.
Domain whitelist dipakai untuk integrasi web, IP whitelist dipakai untuk server, bot, POS, worker, atau tools internal.

Buka dashboard client → Account, lalu aktifkan two-factor authentication.

Buka API Integration, pilih Live/Test, lalu generate API key dan API secret.

Tambahkan domain untuk integrasi web atau IP untuk backend/bot/tools server-to-server.

Tambahkan Webhook URL HTTPS dan simpan webhook secret di backend client.

Backend client memanggil API Azul303 dengan amount dan return_url opsional.

Update order internal berdasarkan webhook success atau status final dari backend client.

Jika QR expired, customer perlu membuat payment baru melalui sistem client.

Gunakan webhook success atau status final dari backend client, bukan status dari browser user.

Jika withdraw gagal, Azul303 membuat rollback ledger untuk mengembalikan saldo client.