Aller au contenu principal

Créer une passerelle de paiement

Pour utiliser les passerelles de paiement dépositaires, vous avez besoin d’un compte Volet.com vérifié. Si vous n’en avez pas encore, consultez Créer un compte, Vérification d’entreprise ou Vérification personnelle.

Les intégrations de paiement non dépositaires ne nécessitent pas de compte Volet.com. Contactez notre équipe pour connaître les détails de l’intégration.

Choisir la méthode d’intégration​

  • Choisissez Hosted Checkout pour l’intégration la plus rapide, avec une page de paiement prête à l’emploi hébergée par Volet.com. C’est aussi la seule méthode d’intégration qui prend en charge les paiements depuis le solde d’un compte Volet.com.
  • Choisissez l’API pour créer votre propre parcours de paiement et maîtriser entièrement l’expérience client.

Comparez API, Hosted Checkout et smart contracts pour choisir la méthode d’intégration adaptée à votre activité.

remarque

Vous pouvez modifier ces paramètres à tout moment après la création de la passerelle.

Option 1 : créer une passerelle Hosted Checkout​

Étape 1 : créer un Hosted Checkout​

Connectez-vous à votre tableau de bord Volet.com, ouvrez Outils de paiement et cliquez sur Créer dans la section Hosted Checkout.

Étape 2 : configurer les moyens de paiement​

Dans le premier onglet, activez les moyens de paiement que vous souhaitez accepter :

MoyenDescription
Utilisateurs Volet.comLes clients paient depuis leur compte Volet.com.
Portefeuilles cryptoLes clients paient en BTC, ETH, USDT, USDC et autres tokens pris en charge depuis n’importe quel portefeuille crypto.

En savoir plus sur chaque moyen :

Pour chaque moyen, configurez Qui paie les frais : indiquez si les frais de traitement sont déduits du montant reçu (Le marchand paie) ou ajoutés au montant payé par le client (L’acheteur paie).

Étape 3 : configurer les paramètres​

Configurez la page Hosted Checkout et les URL de callback.

Options de traitement des paiements​

  1. Utiliser une signature numérique dans les requêtes Hosted Checkout.

    Signe les demandes de paiement et les notifications de callback avec votre mot de passe Hosted Checkout. Cela permet de vérifier que les requêtes proviennent bien de Volet.com et n’ont pas été modifiées en cours de transmission.

    Nous recommandons de laisser cette option activée en production.

  2. Accepter les paiements insuffisants.

    Permet de finaliser une commande lorsque le client envoie moins que le montant demandé.

    Cette option peut être utile pour les paiements en cryptomonnaie, où les frais de réseau, les calculs manuels ou les variations de taux de change peuvent aboutir à un paiement légèrement inférieur au montant attendu.

  3. Accepter les paiements excédentaires.

    Permet de finaliser une commande lorsque le client envoie plus que le montant demandé.

    Cette option peut être utile lorsqu’un client transfère par erreur un montant supérieur à celui demandé.

Configuration de Hosted Checkout​

  1. Nom du Hosted Checkout. Nom qui identifie ce Hosted Checkout dans votre compte Volet.com.

  2. URL du site, de l’application mobile, du bot ou de l’agent IA. Indiquez l’URL publique associée à cette passerelle de paiement. Elle est aussi affichée aux clients pendant le paiement.

Exemples :

  1. E-mail de notification. Adresse e-mail facultative qui reçoit les notifications sur les transactions traitées par cette configuration Hosted Checkout.

  2. E-mail affiché dans Hosted Checkout. Réservé à un usage futur.

  3. Mot de passe Hosted Checkout. Clé secrète servant à signer les demandes de paiement et à vérifier les notifications de callback. Gardez-la confidentielle et ne l’exposez pas dans le code côté client.

Configuration des URL de statut​

Configurez ensuite les URL de callback et de redirection. Vous pouvez omettre ces paramètres et/ou les indiquer dans le formulaire de demande de paiement.

  1. Success URL. URL vers laquelle le client est redirigé après un paiement réussi.

  2. Failed URL. URL vers laquelle le client est redirigé si le paiement échoue ou est annulé.

  3. Status URL. Point de terminaison de votre serveur qui reçoit les notifications de statut des paiements. Utilisez-les pour mettre à jour automatiquement le statut des commandes dans votre système.

Pour Success URL, Failed URL et Status URL, vous pouvez choisir la méthode HTTP :

  • GET : les paramètres sont envoyés dans la query string.
  • POST : les paramètres sont envoyés dans le corps de la requête.

Étape 4 : personnaliser l’apparence (facultatif)​

Facultatif, peut être configuré plus tard.

Vous pouvez personnaliser la page Hosted Checkout avec votre logo et les couleurs de votre marque.

Étape 5 : approbation​

Les passerelles nouvellement créées doivent être approuvées par un administrateur avant de pouvoir accepter des paiements réels.

L’approbation prend généralement quelques heures.

Vous recevrez un e-mail lorsque votre passerelle sera approuvée et prête à l’emploi.

remarque

Vous ne pouvez pas traiter de paiements réels avant l’approbation de la passerelle. Profitez-en pour finaliser l’intégration sur votre site.

Étape 6 : intégrer Hosted Checkout​

Une fois la passerelle approuvée, vous pouvez intégrer Hosted Checkout à votre site, votre application, votre bot ou votre agent IA.

Voir : Intégration de Hosted Checkout

Option 2 : créer une passerelle API​

Étape 1 : créer une passerelle API​

Connectez-vous à votre tableau de bord Volet.com, ouvrez Outils de paiement et cliquez sur Créer dans la section API.

Étape 2 : configurer les paramètres de l’API​

Configurez les paramètres de base de l’API.

  1. Nom de l’API. Nom interne de la passerelle API. Il n’est utilisé que dans votre compte Volet.com.

  2. Liste blanche d’IP. Liste des adresses IP autorisées à accéder à l’API.

    Vous pouvez :

    • Saisir manuellement une ou plusieurs adresses IP.
    • Cliquer sur Ajouter l’IP actuelle pour ajouter automatiquement votre adresse IP actuelle.
    • Activer Autoriser toutes les IP pour désactiver les restrictions par IP (déconseillé en production).

  3. Mot de passe de l’API. Clé secrète servant à authentifier les requêtes API. Gardez-la confidentielle et ne l’exposez pas dans le code côté client.

  4. URL du site, de l’application mobile, du bot ou de l’agent IA. Indiquez l’URL publique associée à cette intégration API.

Exemples :

  1. E-mail de notification. Adresse e-mail facultative qui reçoit les notifications sur les transactions traitées par cette passerelle API.

Étape 3 : configurer les autorisations de l’API​

Choisissez les autorisations disponibles pour cette passerelle API.

Pour une intégration d’acceptation de paiements, activez :

  • Effectuer des transactions
    • Accepter les paiements crypto : permet à votre application de créer des factures et d’accepter des paiements en cryptomonnaie depuis des portefeuilles crypto.
  • Rechercher une transaction : permet à votre application de récupérer le statut du paiement et le détail de la transaction après la création d’une facture.

Les intégrations API n’utilisent pas d’URL de callback. Après avoir créé une facture, votre application doit utiliser Rechercher une transaction pour vérifier le statut actuel du paiement.

D’autres autorisations, comme la consultation des soldes, l’historique des transactions, les échanges et les paiements sortants, peuvent être activées plus tard si votre intégration en a besoin. Voir la référence de l’API pour plus de détails.

Étape 4 : approbation​

Les passerelles API nouvellement créées doivent être approuvées par un administrateur avant de pouvoir traiter des transactions réelles.

L’approbation prend généralement quelques heures.

Vous recevrez un e-mail lorsque votre passerelle API sera approuvée et prête à l’emploi.

remarque

Vous ne pouvez pas traiter de transactions réelles avant l’approbation de la passerelle API.

Étape 5 : intégrer​

Une fois la passerelle approuvée, vous pouvez commencer à accepter des paiements via l’API.

Voir :

  • Intégration API : guide pratique d’intégration d’une passerelle de paiement API.
  • Référence de l’API : documentation complète des méthodes, paramètres et réponses.