Panduan praktis infrastruktur pembayaran API-first untuk merchant Indonesia

"API-first" berarti API adalah cara utama memakai produk, dan semua hal lain, termasuk dashboard, dibangun di atas catatan yang sama. Untuk pembayaran, artinya checkout, aplikasi, dan back office Anda terhubung ke satu sistem, dan tidak ada yang bergantung pada seseorang yang menyalin angka secara manual.

Mengapa cocok untuk merchant Indonesia

Bisnis online di Indonesia sering berjualan di beberapa kanal sekaligus: website, aplikasi, toko di marketplace, kadang toko lewat chat. Dengan platform pembayaran API-first:

• setiap kanal membuat pembayaran dengan cara yang sama, memakai nomor pesanan Anda sendiri;
• setiap kanal mengetahui pembayaran dengan cara yang sama, lewat webhook bertanda tangan;
• tim keuangan melihat semuanya di satu tempat, dengan jumlah kotor, biaya, dan bersih yang sama.

Rencanakan integrasi dalam lima langkah

1. Petakan alurnya. Tulis dari mana pembayaran dimulai (checkout, tagihan, top-up) dan apa yang harus terjadi saat pembayaran lunas, gagal, atau kedaluwarsa.

2. Tentukan nomor pesanan. Gunakan nomor pesanan Anda sendiri sebagai merchant_reference. Nomor ini menghubungkan PAYWISE dengan sistem Anda dan melindungi dari duplikat: mengirimnya lagi mengembalikan pembayaran yang sama. Kirim juga customer_id (ID pengguna, username, atau email) agar Anda tahu siapa yang membayar.

3. Tentukan cara pelanggan membayar. Tampilkan kode QR atau alamat USDT di halaman Anda sendiri, atau arahkan pelanggan ke halaman pembayaran PAYWISE (checkout_url) yang sudah menangani hitung mundur dan pembaruan status. Pilihan kedua lebih cepat dibuat.

4. Kerjakan webhook lebih dulu. Bangun dan uji handler webhook sebelum tampilan checkout. Bagian inilah yang menentukan apakah pesanan lunas, jadi perlu perhatian paling besar. Verifikasi setiap tanda tangan.

5. Uji, lalu live. Jalankan semua skenario di sandbox, termasuk yang gagal, lalu ganti key pw_test_ dengan key pw_live_.

Dasar-dasar keamanan

• Simpan API key hanya di server, jangan pernah di aplikasi atau browser.
• Batasi setiap key ke alamat IP server Anda di halaman Kunci API.
• Aktifkan login dua langkah untuk tim, dan beri setiap orang hanya peran yang ia butuhkan.
• Jangan tandai pesanan lunas hanya dari return URL pelanggan: tunggu webhook, atau cek transaksinya lewat API.

Belum punya developer? Mulai dengan plugin

Jika Anda memakai WooCommerce, plugin PAYWISE menyediakan QRIS dan USDT di checkout tanpa coding. SDK PHP dan Node.js di halaman Developer membuat integrasi khusus lebih singkat.

Jika sudah siap, dokumentasi API berisi setiap endpoint, field, dan kode error.