URI permintaan pembayaran adalah tautan yang dimulai dengan zcash: dan memuat detail pembayaran: alamat, jumlah, dan memo opsional.
Dibagikan sebagai kode QR atau tautan yang dapat diklik, URI ini memungkinkan dompetmu mengisi pembayaran untukmu. Kamu memeriksa detailnya lalu menyetujui.
ZIP 321 mendefinisikan formatnya. Format ini berasal dari BIP 21 milik Bitcoin.
Satu permintaan dapat membayar beberapa penerima dalam satu transaksi.
ZecHub menyediakan widget pembayaran dan generator, sehingga toko dapat menambahkan tombol pembayaran Zcash tanpa menulis URI secara manual.
Penjelasan Inti
URI permintaan pembayaran adalah tautan zcash: yang didefinisikan oleh ZIP 321. Dompet yang kompatibel membaca alamat, jumlah, dan memo opsional dari tautan atau QR lalu mengisi awal transaksi. Tidak perlu akun tambahan, tidak ada pemroses di tengah.
Demo widget adalah modal ZIP-321 langsung: QR, salin alamat/URI, tautan singkat, dan Buka di Dompet. Halaman alat adalah generator jika kamu ingin terlebih dahulu menetapkan alamat dan jumlahmu sendiri.
ZEC desimal dengan . sebagai pemisah dan paling banyak 8 angka desimal (0.5, bukan 0,5)
memo
tidak
Hanya alamat terlindungi. Byte UTF-8 memo (paling banyak 512), dienkode base64url tanpa padding =: Thanks! menjadi VGhhbmtzIQ, bukan teks biasa
label
tidak
Nama yang dapat dibaca manusia dan ditampilkan oleh beberapa dompet. Enkode persen untuk spasi dan karakter cadangan (Coffee%20shop); + adalah tanda plus literal, bukan spasi
Bayangkan formulir transfer bank dengan bidang untuk nomor rekening, jumlah, dan catatan yang menjelaskan tujuan pembayaran. Mengisinya secara manual lambat, dan satu digit yang salah akan mengirim uang ke tempat yang salah.
URI permintaan pembayaran adalah formulir tersebut, yang telah diisi oleh toko. Kode QR adalah foto formulir itu. Kamera ponselmu membaca foto tersebut, dompet menyalin setiap bidang ke tempatnya, lalu kamu memeriksa angka dan menandatangani.
Tautan di halaman web melakukan hal yang sama. Mengekliknya menyerahkan formulir yang telah diisi kepada dompetmu.
Pembahasan Mendalam
Contoh nyata
Berikut contoh dari ZIP 321, yang ditulis untuk testnet:
URI ini meminta 1 ZEC untuk satu alamat Sapling terlindungi. Memo didekode menjadi "This is a simple memo." Pesan "Thank you for your purchase" adalah teks yang ditampilkan dompet di layar.
Aturan yang diperiksa dompet
Format jumlah bersifat ketat. amount=0.5 dan amount=50 valid. amount=50,000.00, amount=.5, dan amount=0.123456789 tidak valid: titik adalah satu-satunya pemisah desimal, dan maksimal hanya boleh ada 8 digit setelahnya. Jumlah tidak boleh melebihi 21.000.000 ZEC.
Dalam URI mentah, memo dienkode dalam base64url, dan dapat memuat hingga 512 byte setelah didekode. Memo yang dilampirkan pada alamat transparan membuat seluruh permintaan tidak valid, karena alamat transparan tidak dapat membawa memo. Alamat Sprout sama sekali tidak diizinkan, dan permintaan yang tidak mengikuti tata bahasa ZIP 321 harus ditolak.
Dua bidang lain tersedia selain tabel di atas. message adalah deskripsi pembayaran untuk ditampilkan dompet. req-asset dicadangkan untuk Custom Assets, sebagaimana didefinisikan dalam ZIP 227.
Membayar beberapa orang sekaligus
Setiap pembayaran tambahan diberi nomor indeks pada nama parameternya, misalnya address.1, amount.1, dan memo.1. Dompet membuat satu transaksi yang membayar semua orang dalam daftar. Ini berguna untuk checkout yang membagi pembayaran, atau untuk sekelompok donasi yang dikirim bersamaan.
Asal format
Bitcoin memiliki dua standar lama untuk permintaan pembayaran: BIP 21, tautan sederhana untuk satu penerima, dan BIP 70, protokol yang lebih berat untuk pembayaran kompleks. ZIP 321 mengambil jalan tengah, yaitu format tautan yang menyediakan ruang untuk beberapa penerima. Pembahasannya dimulai pada 2018 di repositori ZIPs Zcash, tempat nomor 321 dipilih untuk menggemakan BIP 21, dan ZIP itu sendiri dibuat pada Agustus 2020.
Halaman Terkait
Memo: Kegunaan bidang memo dalam permintaan pembayaran.
