Modal di atas halaman AndaSegera hadir
Jendela pembayaran terbuka di atas halaman saat ini, sehingga pelanggan tetap di posisi keranjangnya.
Embedded checkout
Embedded checkout di dalam situs Anda
Jendela pembayaran terbuka di atas halaman Anda sebagai modal, sehingga pelanggan tidak pernah meninggalkan toko. Logika invoice yang sama dengan halaman hosted checkout.
Modal di halaman AndaLogika invoice yang samaStatus webhook
Cara kerja
Dari invoice ke status final
Halaman Anda membuka jendela pembayaran dengan invoice yang dibuat lewat API.
Pelanggan membayar di dalam modal, tanpa redirect.
Status final datang lewat webhook dan modal ditutup.
Fitur
Yang Anda dapatkan
Logika invoice yang samaSegera hadir
Nominal, aset, jaringan, dan kurs tetap bekerja persis seperti di halaman hosted checkout.
Status lewat webhook
Status pesanan berasal dari webhook final, bukan dari kondisi jendela browser.
Berfungsi di situs mana punSegera hadir
Cukup satu pemanggilan skrip untuk membuka jendela pembayaran di toko Anda.
Cara lain menerima pembayaran
Produk pembayaran lainnya
Qvard mendukung beberapa produk pembayaran. Pilih yang sesuai dengan kanal penjualan Anda.
FAQ
FAQ
A quick overview of how Qvard handles payments, integration and merchant operations.
Apa itu Qvard?
Qvard adalah gateway pembayaran crypto untuk bisnis dengan hosted checkout, invoice, pembayaran API, dan saldo merchant.
Aset apa saja yang didukung?
Qvard mendukung USDT, USDC, BTC, LTC, TRX, BNB, dan ETH. TON dan USDT di TON segera hadir.
Apakah cocok untuk developer?
Ya. Qvard mencakup pembayaran API, redirectUrl, webhook, percobaan ulang, dan log pengiriman.
Bisakah saya menyesuaikan checkout?
Checkout mendukung logo merchant, nama toko, warna tombol, dan lokalisasi. URL pengembalian kustom segera hadir.
Apa yang perlu saya siapkan untuk mulai?
Buat akun merchant dan selesaikan verifikasi bisnis. Setelah menguji invoice demo, hubungkan hosted checkout atau API dan mulai menerima pembayaran sungguhan.
Bagaimana cara kerja withdrawal?
Dana dilacak di saldo merchant yang terpisah menurut aset dan jaringan. Anda bisa menarik secara manual atau mengatur aturan withdrawal untuk pembayaran otomatis.
Mulai cepat
Integrasikan widget checkout Qvard dengan tiga cara:
Kunci publik Anda (qvard_pk_…) dapat tetap ada di kode halaman. Itu hanya dapat membuat pembayaran untuk toko Anda—tidak dapat membaca data atau menarik dana. Hanya berfungsi dari domain di Asal yang Diizinkan Anda, dan memiliki batas laju.
Apakah server Anda perlu menghitung jumlah atau memeriksa inventaris? Gunakan tab "Melalui server Anda": backend Anda membuat pembayaran dengan kunci rahasia (qvard_sk_…), dan hanya URL pembayaran yang masuk ke browser.
<script src="https://qvard.com/checkout.js"></script> <script> // 1. Jelaskan pembayaran var checkout = new QvardCheckout({ mode: 'modal', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, orderId: 'order-123', onSuccess: function (e) { // 3. Tangani hasilnya console.log('paid', e.paymentId); }, onError: function (err) { console.log(err.code); } }); // 2. Buat dan tampilkan jendela checkout.open(); </script>
# Buat pembayaran di server Anda curl -X POST https://api.qvard.com/api/v1/payment \ -H 'x-api-key: qvard_sk_YOUR_SECRET_KEY' \ -H 'Content-Type: application/json' \ -d '{"price":10,"id":"order-123"}' # Respons: {"id":"...","redirectUrl":"https://my.qvard.com/pay/..."} // Buka jendela pembayaran di browser <script src="https://qvard.com/checkout.js"></script> <script> // 1. Jelaskan pembayaran var checkout = new QvardCheckout({ mode: 'modal', paymentUrl: 'https://my.qvard.com/pay/...', // Ambil redirectUrl dari respons server onSuccess: function (e) { // 3. Tangani hasilnya console.log('paid', e.paymentId); } }); // 2. Buat dan tampilkan jendela checkout.open(); </script>
<div id="checkout"></div> <script src="https://qvard.com/checkout.js"></script> <script> // 1. Jelaskan pembayaran var checkout = new QvardCheckout({ mode: 'inline', target: '#checkout', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, onSuccess: function (e) { // 3. Tangani hasilnya console.log('paid', e.paymentId); } }); // 2. Buat dan tampilkan jendela checkout.open(); </script>
Referensi API lengkap: api.qvard.com/doc
Opsi konfigurasi
| Opsi | Deskripsi |
|---|---|
| mode | modal | inline |
| target | Pemilih CSS atau elemen DOM (hanya mode inline) |
| publishableKey | Kunci publik Anda—diperlukan untuk membuat pembayaran dari browser |
| paymentId | UUID pembayaran yang sudah dibuat—diperlukan untuk alur server |
| paymentUrl | URL pembayaran lengkap dari respons server—diperlukan untuk alur server |
| price | Jumlah dalam USD (diperlukan dengan publishableKey) |
| orderId | ID transaksi Anda (opsional, maks 128 karakter, dibuat otomatis jika dihilangkan) |
| paymentSystemId | ID metode pembayaran (opsional, dari pengaturan akun) |
| locale | Bahasa halaman pembayaran: en, ru, es, pt, tr, id, vi, fr, de (standar adalah bahasa browser) |
| theme | light | dark (opsional) |
| onSuccess | Callback saat pembayaran berhasil: function(e) { console.log(e.paymentId); } |
| onClose | Callback saat pengguna menutup jendela tanpa membayar |
| onError | Callback saat terjadi error: function(err) { console.log(err.code, err.message); } |
Kode error: invalid_mode, invalid_target, invalid_options, invalid_payment_url, network_error, invalid_key, origin_not_allowed, duplicate_order, rate_limited, invalid_request, payment_failed.