RugWard Pay
Invoice, tautan pembayaran, dan pembayaran uji
Buat invoice di dasbor, bagikan tautan dan tombol pembayaran yang dapat dipakai ulang, coba seluruh checkout gratis di testnet, dan tangani pembayaran yang tidak cocok.
Di halaman ini
Membuat invoice#
Di dasbor, isi New invoice lalu klik Create invoice. Anda mendapat tautan checkout untuk dikirim ke pembeli (https://rugward.com/pay/i/<id>).
| Kolom | Aturan | Catatan |
|---|---|---|
| ① Amount (USD) | $1 hingga $50.000, maksimal 2 desimal (25 atau 25.50) | Pembeli membayar nilai setara dalam koin yang dipilihnya. |
| ② Expires after | 30 menit, 1 jam (bawaan), 3 jam, 1 hari, atau 7 hari di dasbor; 15 menit hingga 7 hari lewat API | Setelah kedaluwarsa, checkout menampilkan "Do not send anything" dan kurs baru tidak bisa dikunci. |
| ③ Order id (opsional) | hingga 64 karakter: huruf, angka, dan . _ - : # / | Referensi Anda sendiri; dikembalikan di API dan webhook. |
| ④ Return URL (opsional) | alamat https:// lengkap | Ditampilkan kepada pembeli hanya setelah invoice lunas, sebagai tombol "Return to <situs Anda>". |
| Description (opsional) | hingga 200 karakter | Ditampilkan kepada pembeli, misalnya "1 × kaos, ukuran M". |
Pembeli memilih koin di halaman checkout. Kurs dikunci 30 menit sejak saat itu (bukan sejak invoice dibuat), sehingga masa berlaku invoice yang panjang tidak membuat Anda terpapar pergerakan harga.
Kirim barang hanya setelah dasbor (atau webhook invoice.paid) menyatakan Paid. Pembeli yang tiba di URL kembali Anda bukan bukti pembayaran: siapa pun bisa membuka URL.
Daftar dan detail invoice#
Invoices menampilkan invoice terbaru Anda dengan tanggal, jumlah, id pesanan, dan status. Details membuka satu invoice: kuotasi (koin, jumlah, kurs, alamat), setiap pembayaran yang terlihat on-chain beserta konfirmasi dan tautan explorer-nya, serta tombol Open checkout, Payment proof (invoice lunas), dan Cancel invoice.
Label status yang akan Anda lihat:
| Label | Status API |
|---|---|
| Awaiting payment (menunggu pembayaran) | open |
| Payment detected, confirming (pembayaran terdeteksi, menunggu konfirmasi) | pending |
| Paid (lunas) | paid |
| Paid (more than requested) (lebih bayar) | overpaid |
| Underpaid (kurang bayar) | underpaid |
| Paid after expiry (dibayar setelah kedaluwarsa) | late |
| Expired (kedaluwarsa) | expired |
| Canceled (dibatalkan) | canceled |
Arti masing-masing dan apa yang harus dilakukan: Status, konfirmasi, dan bukti.
Membatalkan invoice#
Anda dapat membatalkan invoice Anda sendiri selama masih open dan belum ada pembayaran yang terlihat. Checkout lalu memberi tahu pembeli: "The merchant canceled this invoice. Do not send anything to it." Webhook: invoice.canceled. Invoice yang pembayarannya sedang dalam perjalanan tidak dapat dibatalkan (409).
Tautan dan tombol pembayaran#
Tautan pembayaran adalah tautan yang dapat dipakai ulang dengan harga tetap: produk, donasi, keanggotaan bulanan. Setiap pembeli yang mengklik Pay with crypto mendapat invoice barunya sendiri (berlaku 60 menit), sehingga pembayaran tidak pernah tercampur.
- Masukkan jumlah dalam USD, deskripsi, dan URL kembali opsional, lalu Create link.
- Dasbor menampilkan tampilan pembeli (persis yang dilihat pembeli), tautan
https://rugward.com/pay/l/<id>, dan berapa kali tautan dipakai. - Copy link untuk membagikannya di chat, email, atau media sosial, atau Copy button HTML untuk memasang tombol "Pay with crypto" di situs Anda.
- Turn off menghentikan tautan. Invoice yang sudah dibuat darinya tidak terpengaruh.
Tombol ini adalah tautan HTML biasa. Tidak memuat skrip apa pun dan tidak memasang cookie:
<a href="https://rugward.com/pay/l/k33JZ0ij5F2yLDprwrQgjN" target="_blank" rel="noopener"
style="display:inline-block;padding:10px 20px;border-radius:12px;background:#f0b90b;color:#000;font:600 15px system-ui,sans-serif;text-decoration:none">Pay with crypto</a>
Perlu diketahui:
- Invoice yang dibuat dari tautan membawa id pesanan
link:<8 karakter pertama id tautan>, sehingga Anda bisa membedakannya di daftar, API, dan webhook. - Batasan: 100 tautan aktif per merchant; satu tautan membuat paling banyak 100 invoice per jam (melindungi kuota invoice per jam Anda dari penyalahgunaan). Membuka tautan dilindungi Cloudflare Turnstile bila diperlukan.
Invoice uji (gratis, testnet Sepolia)#
Buka Test invoice (Sepolia testnet) di dasbor untuk mencoba checkout lengkap tanpa uang sungguhan. Pembeli membayar dengan ETH uji Sepolia atau USDC uji Sepolia dari Circle melalui splitter RugWard Pay yang di-deploy di Sepolia, yang mengirim 99,5% ke alamat penerimaan dan 0,5% ke dompet biaya RugWard, persis seperti di Base.
- Jumlah: $1 hingga $100. Alamat penerimaan uji opsional (alamat EVM); jika tidak diisi, alamat EVM Anda yang dipakai.
- Koin uji tidak bernilai. Koin ini gratis: ETH Sepolia dari faucet (misalnya faucet Sepolia Google Cloud) dan USDC uji dari faucet Circle (pilih Ethereum Sepolia).
- Invoice uji ditandai TEST di checkout, di daftar, dan di bukti; invoice ini tidak pernah memanggil webhook Anda dan tidak dapat dibuat dengan kunci API, sehingga uji coba tidak akan pernah memicu pengiriman pesanan sungguhan.
Pembayaran yang tidak cocok#
Terkadang transfer tiba di alamat Anda tetapi tidak cocok persis dengan invoice: jumlah salah, pembayaran yang dikirim jauh setelah kedaluwarsa, atau transfer yang tidak terkait. RugWard tidak pernah menandainya sebagai lunas secara otomatis. Jika ada, dasbor menampilkan kotak Unmatched payments berisi jumlah, jaringan, tautan transaksi, dan invoice yang sedang diperiksa saat pembayaran itu terlihat.
Yang harus dilakukan: buka transaksinya, hubungi pembeli, dan selesaikan sendiri (kirim barang, atau kembalikan uang dari dompet Anda). Lalu klik Dismiss.
Terakhir diperbarui: 30 Oktober 2026