SDK JavaScript untuk checkout crypto: direncanakan dan berjalan hari ini
SDK JavaScript untuk checkout crypto dijelaskan: skrip yang direncanakan untuk membuka jendela pembayaran, isi peta jalan Qvard, dan yang berjalan hari ini.
SDK JavaScript untuk checkout crypto akan membuka jendela pembayaran dengan beberapa baris kode di situs Anda. Low-Code SDK Qvard ada di peta jalan dan belum dirilis. Panduan ini menjelaskan idenya dan menunjukkan alur v1 yang sudah bisa Anda pakai sekarang.
Apa yang dilakukan SDK checkout
SDK checkout adalah pustaka JavaScript kecil yang dimuat situs untuk memulai pembayaran. Ia menggambar jendela pembayaran, memandu pelanggan melalui langkah-langkahnya, dan mengembalikan status ke halaman. Logika pesanan tetap di server merchant.
Status: SDK ada di peta jalan
Low-Code SDK Qvard belum dirilis, dan artikel ini tidak menggambarkannya sebagai pustaka yang sudah jadi. Potongan di bawah adalah pratinjau pemanggilan yang direncanakan, bukan kode yang bisa dijalankan hari ini.
Yang berjalan hari ini
Buat pembayaran di server dengan POST /api/v1/payment dan header x-api-key, arahkan pelanggan ke redirectUrl yang dikembalikan di halaman checkout hosted, dan terima status final lewat webhook. Ini setara fungsional dengan pemanggilan SDK yang direncanakan.
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
}Pemanggilan dari server
Kirim id pesanan sebagai id dan harga dalam USD sebagai price. Simpan kunci API di server; browser hanya menerima redirectUrl yang dikembalikan server.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Pemanggilan SDK yang direncanakan
SDK di peta jalan diharapkan membuka alur pembayaran yang sama dari halaman dengan satu pemanggilan. Nama metode dan opsinya bisa berubah sebelum rilis, jadi jangan membangun di atas pratinjau dulu.
Cara menyiapkan diri
Simpan pembuatan pembayaran dalam satu fungsi backend dan pisahkan handler webhook. Saat SDK dirilis, hanya pemanggilan front-end yang berubah; pemanggilan server dan webhook tetap sama.
FAQ
Apakah ada SDK JavaScript checkout Qvard hari ini?
Belum. Low-Code SDK ada di peta jalan. Hari ini hasil yang sama didapat lewat API, halaman checkout hosted, dan webhook.
Bisakah saya memakai pemanggilan QvardCheckout.open() sekarang?
Tidak. Itu hanya pratinjau API yang direncanakan. Gunakan POST /api/v1/payment dan arahkan ke redirectUrl.
Apakah perlu pustaka JavaScript untuk menerima crypto hari ini?
Tidak. Tombol biasa yang memanggil backend dan mengarahkan ke redirectUrl sudah cukup; webhook mengonfirmasi pembayaran.
Bagaimana cara menguji alurnya?
Buat invoice demo dan pastikan webhook Anda menerima status final.
