curl -X POST 'https://vontapaymerchant.web.id/api/v1/transactions' \
-H 'X-API-Key: cp_live_GANTI_DENGAN_API_KEY' \
-H 'Idempotency-Key: order:INV-0001' \
-H 'Content-Type: application/json' \
-d '{
"amount": 25000,
"reference": "INV-0001"
}' API QRIS H2H VONTAPAY
Integrasi API QRIS H2H untuk bot, backend, dan website.
Hubungkan sistem auto-order ke VontaPay untuk membuat transaksi QRIS, menampilkan kode pembayaran, serta membaca status transaksi secara terprogram.
HOST-TO-HOST
Apa yang dimaksud QRIS H2H di VontaPay?
H2H atau host-to-host adalah komunikasi langsung antara server merchant dan API VontaPay. Sistem kamu mengirim request transaksi, menerima data QRIS, lalu memeriksa status menggunakan ID transaksi yang tersimpan pada order.
Request dilakukan dari backend agar API key tidak terlihat di browser. Setiap order menggunakan referensi dan Idempotency-Key unik untuk mencegah transaksi ganda saat terjadi retry.
CONTOH REQUEST
Mulai dengan endpoint transaksi VontaPay.
Panggil endpoint dari server kamu. Jangan pernah meletakkan API key pada JavaScript browser atau aplikasi yang dapat dibaca pengguna.
{
"success": true,
"data": {
"transaction_id": "TRX-A84F19C2",
"reference": "INV-0001",
"amount": 25000,
"status": "PENDING",
"qr_image_url": "https://vontapaymerchant.web.id/api/qr/..."
}
}UNTUK SISTEM AUTO-ORDER
Alur transaksi yang aman untuk diulang dan dipantau.
Simpan transaksi
Simpan ID transaksi VontaPay bersama ID pesanan internal sebelum memulai pengecekan status.
Gunakan idempotency
Kirim satu kunci unik per order agar retry jaringan tidak menghasilkan pembayaran baru.
Periksa status
Gunakan endpoint status sampai transaksi menjadi PAID atau mencapai status terminal lainnya.
Proses satu kali
Pastikan pemenuhan produk bersifat idempoten agar callback proses internal tidak menggandakan order.
DOKUMENTASI API V1
Lihat contoh lengkap Python, Node.js, dan Next.js.
Ikuti format request dan response yang digunakan endpoint produksi VontaPay.