Popup checkout crypto: cara kerja dan yang direncanakan
Popup checkout crypto dijelaskan: cara kerja jendela pembayaran, rencana SDK Qvard untuknya, dan apa yang bisa dijalankan hari ini. Dengan kode.
Popup checkout crypto adalah jendela pembayaran yang terbuka di atas halaman saat ini, sehingga pelanggan membayar tanpa meninggalkan situs. Popup ini direncanakan sebagai bagian dari SDK Qvard dan belum dirilis. Panduan ini menjelaskan cara kerja popup seperti itu dan apa yang bisa Anda jalankan hari ini dengan API.
Cara kerja jendela pembayaran
Halaman memanggil sebuah fungsi, jendela terbuka di atas konten, pelanggan menyelesaikan pembayaran di dalamnya, lalu jendela tertutup. Toko tetap di latar belakang, dan pesanan dikonfirmasi di server.
Status: popup ada di peta jalan
Popup checkout Qvard belum dirilis, dan artikel ini tidak menggambarkannya sebagai fitur jadi. Kode di media adalah pratinjau pemanggilan yang direncanakan.
Yang berjalan hari ini
Buat pembayaran dengan POST /api/v1/payment dan header x-api-key, lalu arahkan pelanggan ke redirectUrl di halaman checkout hosted. Terima status final lewat webhook. Dengan cara ini pelanggan mendapat hasil pembayaran yang sama tanpa popup.
x-api-key: sk_live_…
{
"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
}Membuka jendela baru dengan hati-hati
Jika Anda lebih suka jendela terpisah, buka redirectUrl di tab baru hanya setelah klik. Browser memblokir jendela yang terbuka tanpa aksi pengguna, jadi klik harus datang lebih dulu.
Konfirmasi pembayaran di server
Jendela, saat tersedia nanti, akan menampilkan kemajuan di halaman, tetapi status lunas tetap harus datang dari webhook. Bangun logika pesanan di sekitar webhook sekarang.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Yang sebaiknya dihindari
Jangan anggap jendela yang ditutup sebagai pembayaran gagal, dan jangan tandai pesanan lunas saat jendela ditutup. Tunggu hasil webhook.
FAQ
Apakah ada popup checkout Qvard hari ini?
Belum. Popup direncanakan sebagai bagian dari SDK di peta jalan. Hari ini halaman checkout hosted atau tab baru sudah cukup.
Bisakah popup terbuka tanpa klik?
Browser biasanya memblokirnya. Buka halaman pembayaran setelah klik pengguna.
Bagaimana jika pelanggan menutup jendela?
Jangan tentukan hasil dari peristiwa penutupan. Periksa status pesanan dari webhook.
Bagaimana cara menguji alurnya?
Buat invoice demo dan verifikasi hasil webhook.
