Membuat pembayaran crypto dan mendapatkan redirectUrl
Cara membuat pembayaran crypto dan mendapatkan redirectUrl dalam satu panggilan API: POST /api/v1/payment, header x-api-key, harga dalam mata uang Anda (default USD), dan redirect.
Membuat pembayaran dan mendapatkan redirectUrl adalah satu permintaan di Host-to-Host API v1 Qvard. Panduan ini membahas field permintaan, respons, dan cara mengirim pelanggan ke checkout dengan aman.
Field permintaan
Kirim POST ke /api/v1/payment dengan header x-api-key. id adalah identifier transaksi Anda, price adalah nominal dalam mata uang yang dipilih (default USD), currency adalah kode ISO-4217 opsional seperti INR, RUB, atau EUR, dan paymentSystemId bersifat opsional. Jaga id tetap unik per pesanan agar respons dapat dicocokkan dengan catatan Anda. Mata uang yang tidak didukung ditolak dengan 422 unsupported_currency, kelebihan desimal untuk mata uang itu dengan 422 invalid_amount_precision, dan mata uang tanpa kurs dengan 422 rate_unavailable.
Membaca respons
Respons berisi id pembayaran dan redirectUrl, yang menunjuk ke halaman hosted di https://my.qvard.com/pay/ diikuti id pembayaran. Simpan kedua nilai bersama pesanan sebelum Anda mengarahkan pelanggan.
Mengarahkan pelanggan
Kirim pelanggan ke redirectUrl dengan redirect HTTP biasa atau lewat tautan di situs Anda. Di halaman hosted pelanggan memilih aset dan jaringan, serta melihat nilai persis dengan kurs tetap.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Kesalahan dan percobaan ulang
Jika permintaan gagal, periksa catatan Anda sebelum mengirim ulang agar satu pesanan tidak mendapat dua pembayaran. Catat isi respons untuk dukungan, dan coba ulang hanya setelah memastikan tidak ada pembayaran untuk pesanan itu.
Kesalahan umum
Jangan letakkan x-api-key di kode front-end, jangan anggap redirect sebagai konfirmasi pembayaran, dan jangan kirim harga dalam mata uang selain yang ada di field currency. Status final selalu datang lewat webhook.
Pesanan online, langkah demi langkah
Saat pembeli menekan bayar, server Anda membuat pembayaran dengan id pesanan dan total keranjang, lalu mengarahkan pembeli ke redirectUrl. Ketika webhook melaporkan sudah dibayar, Anda menandai pesanan sebagai lunas.
FAQ
Apakah saya harus mengirim paymentSystemId?
Tidak. Field ini opsional. Kirim jika Anda ingin metode pembayaran tertentu; jika tidak, halaman hosted menampilkan opsi yang tersedia.
Bisakah redirectUrl dipakai ulang untuk pesanan lain?
Tidak. Setiap pembayaran punya redirectUrl sendiri. Buat pembayaran baru untuk setiap pesanan.
Bisakah pelanggan membayar lewat tautan yang saya kirim lewat email?
Bisa. redirectUrl adalah halaman HTTPS biasa, jadi berfungsi di email atau chat. Link pembayaran tanpa kode dari dashboard ada di peta jalan.
Berapa nominal yang dibayar pelanggan?
Halaman hosted menampilkan nominal persis untuk aset yang dipilih dengan kurs tetap selama masa berlaku invoice.
