Cara kerja redirectUrl di checkout kripto

Apa itu redirectUrl

Anda membuat pembayaran dengan satu POST ke https://api.qvard.com/api/v1/payment (header x-api-key, nomor pesanan Anda sebagai id, jumlah sebagai price dalam dolar AS). Responsnya 201 dengan dua field: id, pengenal pembayaran di Qvard, dan redirectUrl, berbentuk https://my.qvard.com/pay/<id>.

Alamat itu mengarah ke halaman pembayaran yang dihosting: halaman yang dijalankan Qvard, bukan server Anda. Anda tidak membangun, menghosting, atau memeliharanya. Tugas Anda adalah membawa pelanggan ke alamat itu, dan mengetahui hasilnya dari webhook sesudahnya.

Apa yang dilihat pelanggan

Di halaman itu pelanggan:

1. memilih aset dan jaringan (atau menemukan yang Anda pilih lebih dulu dengan paymentSystemId);
2. melihat alamat dan jumlah persis yang harus dikirim, dengan jaringan ditampilkan di samping alamat;
3. mengirim transfer dari dompet atau bursanya sendiri.

Kurs di halaman dikunci selama satu jam, jadi jumlahnya tidak berubah saat pelanggan membayar. Halamannya sama bagaimanapun tampilan toko Anda, dan itulah intinya: Anda mendapat checkout kripto yang berfungsi tanpa membangunnya. Untuk melihatnya sebelum integrasi, buka faktur demo.

Memakai tautan di checkout

Penggunaan standar adalah pengalihan di sisi server atau sebuah tombol, dalam tiga langkah:

1. Pelanggan memilih «Bayar dengan kripto». Server Anda membuat pesanan Anda sendiri dan pembayaran Qvard.
2. Server Anda menjawab dengan redirectUrl, sebagai pengalihan HTTP atau sebagai nilai yang dipakai front-end Anda untuk bernavigasi.
3. Browser menuju halaman itu; pelanggan membayar di sana.

Buat pembayaran setelah pelanggan menekan tombol, bukan saat keranjang disusun. Jangan pernah mengirim kunci API rahasia ke browser: browser hanya menerima redirectUrl. Contoh tombol lengkap ada di tombol pembayaran kripto untuk situs web.

Memakai tautan di luar checkout

Karena halamannya dihosting di alamat biasa, tautan juga berfungsi di luar checkout web:

• Di email atau PDF faktur, di samping data bank, agar pelanggan bisnis dapat memilih membayar dengan kripto (lihat pembayaran stablecoin untuk faktur B2B).
• Di obrolan atau pesan dukungan, untuk pembayaran satu kali yang Anda buat manual dengan alat Anda sendiri.
• Di balik kode QR, jika sistem Anda sendiri membuatnya dari alamat.

Perlakukan tautan sebagai pintu masuk ke satu pembayaran itu. Kirim ke pelanggan yang memilikinya dan jangan dipublikasikan. Tautan pembayaran sebagai produk terpisah tanpa kode sedang dikembangkan; hari ini Anda membuat pembayaran lewat API dan membagikan alamat yang dikembalikannya.

Pengulangan, percobaan ulang, dan yang terjadi setelah pembayaran

• Pesanan yang sama dua kali. Mengirim id yang sama untuk metode pembayaran yang sama mengembalikan pembayaran yang ada, jadi klik ganda atau permintaan yang diulang memberi pembayaran yang sama, bukan yang kedua.
• Belum ada URL kembali. Setelah membayar, pelanggan tidak otomatis dikirim kembali ke situs Anda; URL kembali belum tersedia. Beri mereka halaman pesanan yang menampilkan status sebenarnya dan menyegarkan diri selama menunggu.
• Hasilnya adalah webhook. Qvard memanggil callback URL Anda saat pembayaran selesai, dengan id Anda dan statusnya. Endpoint harus menjawab tepat HTTP 200 dan aman bila dijalankan dua kali. Pelanggan yang kembali ke situs bukan bukti pembayaran. Lihat cara mengamankan webhook pembayaran kripto.

Yang tidak dilakukan tautan

Agar Anda tidak mencarinya:

• Ia tidak memberi tahu status pembayaran; tidak ada rute untuk membaca pembayaran berdasarkan id, jadi pakai webhook dan catatan Anda sendiri.
• Ia tidak membawa pelanggan kembali ke situs Anda; URL kembali belum tersedia.
• Ia tidak menggantikan halaman pesanan Anda: Anda tetap membutuhkan yang menampilkan «menunggu», «sebagian», atau «dibayar».

Format permintaan dan respons ada di API pembayaran kripto untuk developer, dan seluruh alurnya di cara menerima pembayaran kripto di situs web.

FAQ