Contoh pembayaran crypto JavaScript: alur yang berjalan hari ini
Contoh pembayaran crypto JavaScript: alur yang berjalan dengan API v1 live, pemanggilan server dan webhook, serta pemanggilan SDK yang ditandai roadmap.
Contoh pembayaran crypto JavaScript ini menunjukkan alur yang berjalan hari ini: server membuat pembayaran dengan API v1 yang live, browser diarahkan ke halaman hosted, dan webhook mengonfirmasi pesanan. Pemanggilan Low-Code SDK di akhir hanyalah pratinjau roadmap.
Alur dalam empat langkah
Pelanggan menekan bayar, server Anda membuat pembayaran, browser menuju redirectUrl, dan webhook mengonfirmasi status final. Setiap langkah berupa panggilan HTTP biasa atau redirect, jadi contoh ini tidak membutuhkan pustaka khusus.
Pemanggilan server dengan JavaScript
Handler Node.js mengirim POST /api/v1/payment dengan header x-api-key, id pesanan, dan harga dalam USD, lalu mengembalikan redirectUrl ke browser. Kunci tidak pernah keluar dari server.
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
}Sisi browser
Halaman cukup memiliki tombol yang memanggil handler Anda lalu mengikuti redirectUrl yang dikembalikan. Di browser tidak ada kunci maupun logika nominal.
Handler webhook
Endpoint webhook membaca id dan status, memeriksa header x-api-key, dan menandai pesanan lunas saat status paid. Buat handler aman untuk diulang, karena pesan yang sama bisa datang dua kali.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Pemanggilan SDK yang direncanakan
Low-Code SDK di peta jalan diharapkan membuka alur yang sama dari halaman dengan satu pemanggilan. Ini pratinjau API yang belum dirilis, hanya untuk orientasi, dan tidak boleh dipakai di produksi.
Uji sebelum go live
Buat invoice demo, bayar di halaman hosted, dan pastikan webhook Anda menerima status final serta menandai pesanan.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });FAQ
Apakah contoh ini memakai SDK?
Tidak. Alur yang berjalan memakai panggilan HTTP biasa dan redirect. Pemanggilan SDK hanya pratinjau roadmap.
Bisakah saya memakai pemanggilan QvardCheckout.open() di produksi?
Tidak. SDK belum dirilis. Gunakan API, redirectUrl, dan webhook.
Di mana kunci API harus disimpan?
Hanya di server. Browser hanya menerima redirectUrl.
Bagaimana tahu pembayaran sudah selesai?
Hanya ketika webhook mengirim id dan status paid.
