API pembayaran crypto: pembayaran server-ke-server
Panduan API pembayaran crypto: buat pembayaran dari server dengan POST /api/v1/payment, dapatkan redirectUrl, dan terima status final lewat webhook.
API pembayaran crypto memungkinkan backend Anda membuat pembayaran, mengirim pelanggan ke halaman pembayaran hosted, dan mengetahui status final tanpa membangun infrastruktur blockchain sendiri. Qvard menyediakan alur ini sebagai Host-to-Host API v1.
Apa yang dilakukan API pembayaran crypto
API pembayaran crypto mengubah peristiwa checkout di server Anda menjadi permintaan pembayaran. Backend Anda mengirim id pesanan dan harga dalam mata uang Anda (default USD), lalu gateway mengembalikan redirectUrl ke halaman pembayaran hosted, tempat pelanggan memilih aset dan jaringan. Alamat, kurs, dan pemantauan blockchain tetap berada di sisi gateway.
Bentuk permintaan v1 Qvard
Pemanggilan berupa satu POST ke /api/v1/payment dengan header x-api-key. Field id berisi id transaksi Anda sendiri dan price berisi nominal dalam mata uang field currency opsional (ISO-4217, default USD). paymentSystemId bersifat opsional dan memilih metode pembayaran jika diperlukan. Respons berisi id pembayaran dan redirectUrl.
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
}Server-ke-server, bukan browser ke gateway
Permintaan dibuat dari backend Anda, sehingga kunci API tidak pernah sampai ke browser. Pelanggan hanya melihat halaman pembayaran hosted setelah Anda mengarahkannya ke sana. Anda juga memeriksa setiap pesanan di sisi Anda sebelum pembayaran dibuat.
Status final datang lewat webhook
Respons API memastikan pembayaran telah dibuat, bukan bahwa sudah dibayar. Status final dikirim ke URL webhook Anda sebagai POST dengan field id dan status, sehingga logika pesanan sebaiknya bereaksi terhadap webhook.
Yang perlu dicek sebelum go live
Simpan id pembayaran bersama pesanan, buat handler webhook aman dijalankan dua kali, dan uji seluruh alur dengan invoice demo. Gunakan id yang sama di setiap permintaan untuk satu pesanan agar pemanggilan berulang dapat direkonsiliasi.
Biaya dan jaringan
Tarif dasar pemrosesan adalah 1% per pembayaran dan turun secara individual hingga 0,1% seiring bertambahnya volume. Biaya jaringan dibayar terpisah di jaringan yang dipilih pelanggan. Halaman harga memuat ketentuan terkini.
FAQ
Apakah API pembayaran crypto sama dengan link pembayaran?
Tidak. Link pembayaran adalah halaman yang bisa dibagikan untuk penjualan manual. API membuat pembayaran dari sistem Anda dan mengembalikan redirectUrl yang dikendalikan kode Anda.
Apakah saya harus menjalankan node blockchain?
Tidak. Qvard memantau jaringan dan melaporkan status final lewat webhook, jadi Anda tidak perlu menjalankan node atau scanner sendiri.
Dalam mata uang apa harga ditulis?
Field price dalam mata uang field currency (ISO-4217, misalnya INR atau EUR); tanpa field itu, dalam USD. Pelanggan membayar dengan aset dan jaringan yang dipilihnya di halaman pembayaran.
Bisakah saya mencoba sebelum go live?
Bisa. Buat invoice demo dan lihat halaman pembayaran hosted yang sama dengan yang akan dilihat pelanggan Anda.
