Menanam checkout stablecoin di toko online Anda
Tanam checkout stablecoin di toko: cara menggunakan widget tertanam, pembuatan pembayaran browser dan server, dan verifikasi webhook.
Menanam checkout stablecoin berarti meletakkan jendela pembayaran USDT atau USDC di dalam toko online Anda. Widget checkout tertanam Qvard menerima stablecoin hari ini. Pelanggan Anda memilih aset kripto dan jaringan di halaman pembayaran, dan Anda memverifikasi pembayaran lewat webhook.
Apa itu checkout stablecoin tertanam
Checkout stablecoin tertanam adalah jendela pembayaran yang terbuka di halaman Anda melalui widget JavaScript. Bisa tampil sebagai modal (pop-up) atau tertanam di elemen. Pelanggan Anda tetap di halaman Anda dan membayar dengan USDT atau USDC tanpa pergi. Jendela pembayaran adalah halaman Qvard yang sama di iframe: pelanggan melihatnya dalam bahasa mereka, memilih aset stablecoin dan jaringan pilihan, dan jumlah dihitung dengan kurs tetap untuk invoice Anda.
Cara kerjanya di Qvard
Widget memuat dari https://qvard.com/checkout.js dan membuka jendela pembayaran stablecoin sebagai modal atau tertanam. Jendela menampilkan aset dan jaringan tersedia; pelanggan memilih, dan jumlah yang dikirim ditunjukkan. Widget memancarkan event: onSuccess (pembayaran berhasil), onClose (jendela tertutup), onError (pembayaran gagal). Instans widget menerima kunci publik Anda (qvard_pk_...) untuk pembuatan sisi browser, atau id pembayaran untuk pembuatan sisi server. Coba di halaman demo di qvard.com.
Dua cara membuat pembayaran
Sisi browser: berikan kunci publik (qvard_pk_...) dan jumlah ke widget; dia membuat pembayaran dan membuka jendela. Pelanggan bisa mengubah jumlah di browser, jadi gunakan untuk tujuan informatif. Kunci publik Anda bisa dibatasi ke situs yang diizinkan di dashboard, dan permintaan rate-limited. Sisi server: backend Anda membuat pembayaran via POST /api/v1/payment dan memberikan id pembayaran ke widget. Untuk pesanan dengan jumlah tetap atau kritis, gunakan pembuatan sisi server dan selalu verifikasi jumlah di webhook Anda. Atau lewati widget dan arahkan pelanggan ke halaman pembayaran yang dihosting.
Sisi server: buat pembayaran terlebih dahulu
Server Anda mengirim permintaan POST ke /api/v1/payment dengan id pesanan dan harga dalam USD, menggunakan header x-api-key dengan kunci rahasia Anda (qvard_sk_...). Respons mengembalikan { id, redirectUrl }. Berikan id ke widget di browser, atau gunakan redirectUrl untuk pengalihan. Simpan kunci rahasia Anda di server; permintaan tidak boleh dibuat dari browser.
x-api-key: qvard_sk_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Verifikasi pembayaran dari webhook
Saat status paid, webhook Anda menerima { id, status }, ditandatangani dengan header X-Qvard-Signature dalam format t=...,v1=... (HMAC-SHA256 dengan kunci rahasia Anda). Verifikasi tanda tangan menggunakan kunci rahasia Anda (qvard_sk_...) dan pastikan jumlah di webhook cocok pesanan Anda. Kunci warisan tanpa prefiks qvard_sk_ juga menerima header x-api-key. Tandai pesanan sebagai lunas hanya setelah verifikasi tanda tangan. Lihat panduan tanda tangan di dokumentasi Qvard.
Kapan memilih jendela tertanam
Gunakan widget modal atau tertanam untuk menjaga pelanggan di halaman Anda dan sediakan checkout stablecoin tanpa hambatan. Halaman yang dihosting dengan pengalihan bekerja sama baiknya dan adalah opsi jika Anda lebih suka tidak menanam jendela pembayaran. Keduanya berbagi proses pembuatan pembayaran, alur webhook, dan verifikasi tanda tangan yang sama.
FAQ
Apakah checkout stablecoin tertanam tersedia di Qvard hari ini?
Ya. Muat widget dari https://qvard.com/checkout.js dan berikan kunci publik Anda (qvard_pk_...) untuk pembuatan sisi browser, atau buat pembayaran sisi server dan berikan id.
Bagaimana pelanggan memilih stablecoin dan jaringan di widget?
Pelanggan melihat aset stablecoin dan jaringan tersedia di halaman pembayaran dan memilih yang ingin digunakan. Jumlah yang dikirim diperbarui berdasarkan pilihan mereka.
Mengapa saya harus memverifikasi jumlah di webhook?
Jumlah di webhook adalah sumber kebenaran dari Qvard. Selalu verifikasi cocok dengan pesanan Anda, bahkan jika Anda membuat pembayaran sisi server, karena pelanggan memilih stablecoin dan jaringan.
Bagaimana cara menguji sebelum launch?
Gunakan halaman demo di qvard.com untuk menguji widget dan melihat event webhook. Pastikan webhook Anda memverifikasi tanda tangan dan menandai pesanan lunas.
