Qu’est-ce qu’une passerelle de paiement host-to-host ?
Qu’est-ce qu’une passerelle de paiement host-to-host : paiements serveur à serveur, redirection vers le checkout hébergé et webhook final, pour les marchands.
Une passerelle de paiement host-to-host relie directement votre serveur au prestataire de paiement. Votre backend crée les paiements, le client paie sur une page hébergée et le prestataire renvoie le résultat à votre serveur.
Ce que signifie host-to-host
Dans le modèle host-to-host, la demande de paiement part de votre serveur vers la passerelle, et non du navigateur. Le client ne rencontre la passerelle que sur la page de paiement hébergée ; les clés et la logique de commande restent chez vous.
Comment fonctionne le parcours
Votre serveur crée un paiement avec POST /api/v1/payment, reçoit un redirectUrl, y envoie le client et reçoit le statut final par webhook. Trois étapes couvrent tout le parcours.
À qui cela s’adresse
Boutiques en ligne, produits SaaS et places de marché qui disposent déjà d’un backend et veulent un contrôle total de la logique de paiement, des statuts de commande et du rapprochement.
Page hébergée et taux fixe
Le client paie sur le checkout hébergé de Qvard, qui affiche le montant exact de l’actif et du réseau choisis, à taux fixe pendant la durée de vie de la facture. Vous n’avez pas à développer la génération d’adresses ni la logique de taux.
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
}Bases de sécurité
Conservez x-api-key côté serveur, vérifiez l’en-tête x-api-key sur chaque webhook et n’acceptez que des endpoints HTTPS. Considérez la redirection comme une navigation, pas comme une confirmation de paiement.
Quand un autre produit convient mieux
Sans backend, un lien de paiement est plus simple. Le checkout intégré, le SDK, le terminal et le checkout Telegram sont sur la feuille de route ; aujourd’hui, le même résultat passe par l’API et la page hébergée.
FAQ
Host-to-host, c’est la même chose qu’une API ?
C’est un modèle fondé sur une API, dans lequel le serveur parle directement à la passerelle. Le terme désigne qui fait l’appel, le serveur, et non un protocole distinct.
Ai-je besoin d’un serveur dédié ?
Non. Tout backend capable d’effectuer des requêtes HTTPS et d’exposer une URL de webhook suffit.
Combien coûte la passerelle ?
Le taux de base est de 1 % par paiement, les taux individuels descendent à 0,1 % avec le volume, et les frais de réseau sont payés à part.
Puis-je combiner host-to-host et la page hébergée ?
Oui, c’est le parcours standard : l’API crée le paiement et la page hébergée l’encaisse.
