Dari request API sampai settlement: di balik layar PAYWISE

Dari luar, pembayaran terlihat sederhana: Anda membuatnya, pelanggan membayar, Anda menerima uangnya. Di dalamnya, ada beberapa langkah teliti yang memastikan setiap pembayaran tercatat sekali, benar-benar dikonfirmasi, dan dibayarkan dengan tepat. Inilah perjalanan lengkapnya.

1. Request Anda masuk

Server Anda memanggil POST /api/v1/transactions dengan API key. PAYWISE pertama-tama mengecek key tersebut: apakah ada, milik akun yang aktif, belum dicabut, dan (jika Anda mengatur daftar IP) berasal dari alamat IP yang diizinkan. Setiap request dicatat dengan X-Request-Id, apa pun hasilnya.

2. Validasi dan pencegahan duplikat

Field-field dicek: jumlah sesuai batas metode, ada customer_id, network BEP20 untuk USDT. Lalu PAYWISE mencari merchant_reference Anda. Jika sudah ada dengan jumlah dan metode yang sama, transaksi lama yang dikembalikan, bukan membuat yang kedua. Karena itulah request ulang setelah timeout selalu aman.

3. Pembayaran dibuat di provider

PAYWISE meminta kode QR (QRIS) atau alamat deposit BEP20 dan jumlah pasti (USDT) dari provider pembayaran yang terhubung. Transaksi disimpan dengan status pending lalu dikembalikan kepada Anda, beserta checkout_url jika halaman pembayaran aktif untuk website Anda. Di sandbox, tidak ada uang sungguhan yang berpindah dan Anda sendiri yang memilih hasilnya.

4. Pelanggan membayar

Pelanggan memindai kode QR dengan aplikasi bank atau e-wallet, atau mengirim USDT ke alamat tersebut. Kode QR bisa dibayar hingga 20 menit, alamat USDT selama 60 menit.

5. Konfirmasi, dicek dua kali

Saat provider melaporkan pembayaran, PAYWISE tidak langsung percaya pada pesan itu. Notifikasi diautentikasi, dicocokkan dengan tepat satu transaksi, lalu dikonfirmasi langsung antar-server dengan provider sebelum transaksi ditandai paid. Pembayaran USDT yang kurang dari jumlah pasti tidak ditandai lunas.

Pada saat itulah biaya dihitung dan dicatat bersama jumlah kotor dan bersih.

6. Webhook Anda dikirim

PAYWISE mengirim webhook payment.paid ke server Anda, ditandatangani dengan HMAC-SHA256. Jika server Anda tidak menjawab dengan 2xx, pengiriman diulang otomatis, dan setiap percobaan dicatat. Pembayaran yang gagal dan kedaluwarsa mengirim payment.failed dan payment.expired.

7. Settlement

• Pembayaran QRIS di-settle dalam batch pukul 10:30, 14:30, 18:30, dan 22:30 WIB, tergantung kapan dibayar.
• Pembayaran USDT langsung di-settle begitu dibayar.

Setelah di-settle, jumlah bersih bisa ditarik, dan Anda menerima notifikasi.

8. Penarikan

Anda mengajukan penarikan dari dashboard atau API: rupiah ke rekening bank, USDT ke wallet BEP20. Statusnya berjalan dari diajukan ke disetujui, diproses, lalu selesai, dan Anda menerima webhook withdrawal.completed saat uang dikirim. Jika gagal, alasannya ditampilkan dan jumlahnya bisa ditarik lagi.

Yang perlu Anda bangun

Hanya tiga hal: membuat pembayaran, menangani webhook, dan menarik dana. Semua hal lain dalam daftar ini dikerjakan oleh PAYWISE. Mulai dari Cara menerima pembayaran QRIS.