Passerelle de paiement personnalisée : API
Pour utiliser la fonction de passerelle de paiement personnalisée, vous devez créer une application : le processus de paiement externe mentionné dans les entrées précédentes. Cette application servira de point d'intégration entre notre API et les méthodes de paiement de votre choix.
Présentation du processus de paiement
Retourner les méthodes de paiement
Comme démontré dans le diagramme ci-dessus, lorsqu'un client atteint l'étape de paiement dans le panier, nous envoyons à votre application une requête utilisant l'URL de vos méthodes de paiement configurées. À ce point, vous pouvez retourner une liste des méthodes de paiement prises en charge. Elles seront affichées comme options de méthode de paiement à l'étape de paiement du panier.
Si un client clique sur l'une de vos méthodes de paiement, il sera redirigé vers votre caisse externe, que vous développez et hébergez vous-même.
Note : un tutoriel étape par étape pour le développement et l'intégration d'une passerelle de paiement personnalisée sera bientôt disponible.
Un mot sur la validation des demandes
Comme étape supplémentaire, nous recommandons fortement de valider que toute demande entrante provient de Snipcart. Les requêtes que nous envoyons à votre point de terminaison contiennent un paramètre de requête nommé publicToken. Vous pouvez retourner ce jeton au point de terminaison de validation pour vous assurer que la demande provient bien de Snipcart.
Si la réponse a un code d'état de succès, vous pouvez supposer qu'elle provient de Snipcart.
Pour plus d'informations, lisez cette entrée sur la référence technique du point de terminaison de validation.
Récupérer la facture de paiement
Lorsque le client arrive sur votre écran de paiement externe, vous devez afficher des informations sur la commande à payer.
Pour ce faire, récupérez la session de paiement, qui contient la facture de la commande en cours, en envoyant une requête au point de terminaison de session de paiement.
Traiter les paiements
Lorsque le client se trouve sur votre système de paiement externe, le reste de la séquence de paiement est à votre discrétion. En général, c'est là que vous recueillez les informations relatives au paiement du client et que vous traitez le débit par le biais de la plateforme de passerelle de paiement que vous intégrez.
Lorsque le paiement réussit (ou échoue), votre intégration doit signaler le résultat à Snipcart en utilisant le point de terminaison de mise à jour du paiement.
Vous serez alors prêt à rediriger le client vers la boutique.
Un mot sur l'hébergement
Lorsqu'il s'agit de créer votre application, il n'y a aucune restriction. Vous pouvez utiliser n'importe quelle technologie et l'héberger comme vous le souhaitez.
Dans les exemples suivants, nous utilisons une approche centrée sur l’application client avec des fonctions sans serveur (serverless) pour gérer les opérations d'administration.