Checkout tiga vendor dengan komisi 4% dan kebijakan pembayaran keluar yang ditinjau.
1. Siapkan proyek
Buka Proyek → Marketplace → Pengaturan. Aktifkan Marketplace dan pilih toko yang berpartisipasi. Biarkan pembayaran keluar dijeda untuk saat ini. Cadangkan dompet proyek dan aktifkan metode Bitcoin atau EVM yang didukung di setiap toko.
Pelanggan membayar ke dompet proyek ini terlebih dahulu. Kamu mengendalikan kunci dan berutang saldo yang tercatat kepada vendor. Sediakan koin native bebas yang terpisah untuk biaya. Sweep biasa tidak dapat membelanjakan alamat penerima Marketplace.
2. Tambahkan dan setujui tiga vendor
Di Vendor, tambahkan setiap penjual dan alamat mainnet Bitcoin. Konfirmasikan alamat secara independen dengan penjual sebelum menyetujuinya. Untuk token EVM, setiap penjual juga membutuhkan alamat yang disetujui pada jaringan yang tepat tersebut.
Atur komisi proyek ke 4%. Penggantian tingkat toko, vendor, dan invoice yang diotorisasi disimpan sebagai snapshot, sehingga penyuntingan berikutnya tidak mengubah alokasi yang ada.
3. Buat invoice bersama
Di Marketplace → Invoice, buat invoice 300 USD dengan tiga bagian bruto vendor masing-masing 100 USD. Totalnya harus sama persis. Kirim tautan checkout kepada pelanggan.
Untuk integrasi API, gunakan kunci Marketplace terpisah dan kirim string desimal ke /v1/marketplace/invoices. Simpan kunci idempotensi sebelum permintaan dan gunakan kembali setelah timeout. Contoh permintaan →
4. Tinjau dan kirim
Tunggu alokasi terverifikasi menjadi tersedia. Pada penawaran terkunci, setiap penjual mendapat nilai setara 96 USD dalam aset yang dibayar dan kamu mempertahankan komisi setara 12 USD. Biaya pemrosesan 1% yang ada, jika dikonfigurasi, menggunakan kredit prabayar 3 USD. Biaya chain terpisah.
Di Pembayaran keluar, siapkan alokasi tersedia dan batasi biaya native serta gas. Bitcoin mengharuskan setiap bagian yang belum dibayar dari invoice terpilih berada dalam batch yang sama. Tinjau penerima dan rencana yang tepat, lalu setujui sekali. Ikuti sampai Dibayar, bukan hanya Disiarkan.
5. Aktifkan otomatisasi dengan hati-hati
Di Pengaturan, tambahkan kebijakan untuk satu aset: pembayaran keluar minimum, batas pokok per pembayaran dan harian, anggaran biaya native serta gas, interval, dan konfirmasi. Aktifkan hanya setelah meninjau batas dan tujuan tersebut, lalu lanjutkan pembayaran keluar dari jeda.
Kebijakan otomatis dapat mengirim tanpa klik tambahan. Kredit rendah atau gerbang transfer server tetap menjeda pembelanjaan. Pemantauan dan buku besar tetap berjalan.
6. Tangani pengecualian tanpa pengiriman duplikat
- Kurang bayar: toleransi checkout tidak menciptakan saldo vendor yang tidak didanai. Tunggu pembayaran tambahan, kembalikan dana, atau setujui secara eksplisit pembagian lebih kecil yang didukung dana penuh.
- Gas token kurang: tambahkan koin native bebas ke dompet proyek dan tinjau pembayaran keluar yang tertahan. Jangan membuat pembayaran keluar kedua untuk melewatinya.
- Timeout webhook: coba ulang event bertanda tangan yang sama. Verifikasi tanda tangan mentah dan proyeknya, simpan event_id secara unik, lalu beri pengakuan penerimaan. Event invoice selesai bukan penyelesaian pembayaran keluar.
- Pengembalian dana setelah vendor dibayar: danai dompet utama secara terpisah, verifikasi alamat pelanggan, siapkan pengembalian penuh dalam aset yang sama, dan setujui. Vendor tidak didebit otomatis.
- Pemulihan atau broadcast tidak pasti: biarkan pembayaran keluar dijeda dan rekonsiliasi hash transaksi yang tersimpan sebelum melanjutkan. Jangan pernah menganggap timeout berarti tidak ada yang dikirim.