Host-to-Host API

Apa itu gateway pembayaran host-to-host?

Apa itu gateway pembayaran host-to-host: pembayaran server-ke-server dengan redirect ke checkout hosted dan webhook final, dijelaskan untuk merchant.

Gateway pembayaran host-to-host menghubungkan server Anda langsung ke penyedia pembayaran. Backend Anda membuat pembayaran, pelanggan membayar di halaman hosted, dan penyedia melaporkan hasilnya kembali ke server Anda.

Arti host-to-host

Dalam model host-to-host, permintaan pembayaran berjalan dari server Anda ke gateway, bukan dari browser. Pelanggan hanya bertemu gateway di halaman pembayaran hosted, sementara kunci dan logika pesanan tetap di sisi Anda.

Cara kerja alurnya

Server Anda membuat pembayaran dengan POST /api/v1/payment, menerima redirectUrl, mengirim pelanggan ke sana, dan menerima status final lewat webhook. Tiga langkah menutup seluruh alur.

Untuk siapa

Toko online, produk SaaS, dan marketplace yang sudah punya backend dan ingin kendali penuh atas logika checkout, status pesanan, dan rekonsiliasi.

Halaman hosted dan kurs tetap

Pelanggan membayar di checkout hosted Qvard, yang menampilkan nominal persis untuk aset dan jaringan yang dipilih dengan kurs tetap selama masa berlaku invoice. Anda tidak perlu membangun pembuatan alamat atau logika kurs.

POST/api/v1/payment
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
}

Dasar keamanan

Simpan x-api-key di server, periksa header x-api-key pada setiap webhook, dan hanya terima endpoint HTTPS. Perlakukan redirect sebagai navigasi, bukan konfirmasi pembayaran.

Kapan produk lain lebih cocok

Tanpa backend, link pembayaran lebih sederhana. Embedded checkout, SDK, Terminal, dan Telegram checkout ada di peta jalan; saat ini hasil yang sama didapat lewat API dan halaman hosted.

FAQ

Apakah host-to-host sama dengan API?

Ini model berbasis API, di mana server berbicara langsung dengan gateway. Istilah ini menjelaskan siapa yang melakukan pemanggilan, yaitu server, bukan protokol terpisah.

Apakah saya perlu server khusus?

Tidak. Backend apa pun yang bisa membuat permintaan HTTPS dan membuka URL webhook sudah cukup.

Berapa biaya gateway?

Tarif dasar 1% per pembayaran, tarif individual turun hingga 0,1% seiring volume, dan biaya jaringan dibayar terpisah.

Bisakah host-to-host dikombinasikan dengan halaman hosted?

Bisa, itu alur standarnya: API membuat pembayaran dan halaman hosted menerimanya.

Artikel terkait

Artikel terkait