Installation
Prérequis
- PHP 7.2 ou supérieur
- Composer
- Accès à l’API Yabetoo (clés API)
- Un compte Yabetoo actif
Installation via Composer
Pour installer le SDK, utilisez Composer. Exécutez la commande suivante dans votre projetConfiguration
Initialisation du SDK
Avant d’utiliser le SDK, vous devez initialiser une instance de la classe Yabetoo. Fournissez simplement votre clé API lors de l’initialisation. Le SDK détecte automatiquement si vous êtes en mode test ou en production.Gestion des paiements avec Yabetoo
Vous pouvez créer des paiements, récupérer des informations sur des paiements spécifiques et gérer les paiements en utilisant la classe Payment. Yabetoo fonctionne sur un modèle de paiements en deux étapes. Cela signifie que, pour traiter un paiement, vous devez d’abord créer une intention de paiement et ensuite confirmer cette intention pour capturer le montant. Cette approche offre une flexibilité accrue, permettant par exemple de vérifier les fonds disponibles ou d’obtenir l’autorisation d’un utilisateur avant de finaliser une transaction. Voici comment cela fonctionne étape par étape :- Créer une intention de paiement : Vous créez une intention de paiement en spécifiant le montant, la devise et d’autres détails pertinents.
- Confirmer l’intention de paiement : Une fois que vous avez créé l’intention, vous pouvez la confirmer pour capturer le montant. Cela peut être fait immédiatement ou à une date ultérieure, selon vos besoins.
- Gérer les paiements : Vous pouvez récupérer des informations sur les paiements, annuler des paiements ou gérer d’autres aspects liés aux transactions.
Créer une intention de paiement
Une intention de paiement est une ressource qui représente votre souhait de recevoir un paiement pour un montant spécifique. Lorsque vous créez une intention de paiement, vous ne capturez pas immédiatement le montant ; c’est une étape préparatoire.Confirmer une intention de paiement
Une fois que vous avez créé une intention de paiement, vous devez la confirmer pour capturer le montant. La confirmation est l’étape où le paiement est réellement traité.Assurez-vous de stocker le
client_secret de manière sécurisée, car il est
nécessaire pour confirmer le paiement.Récupérer les détails d’un paiement
Vous pouvez récupérer les détails d’un paiement spécifique en utilisant son ID :Lister les paiements
Pour obtenir une liste de paiements, vous pouvez utiliser la méthodelist :
Utilisation d’une session de paiement avec Yabetoo
Les sessions de paiement offrent une solution simple et sécurisée pour intégrer les paiements dans votre application. Avec une session de paiement, Yabetoo gère la page de paiement pour vous, réduisant ainsi la complexité de l’intégration et les exigences de conformité.Avantages des sessions de paiement
- Sécurité : Yabetoo gère toutes les données sensibles de paiement.
- Simplicité : Pas besoin de créer votre propre formulaire de paiement.
- Conformité : La page de paiement est déjà conforme aux normes de sécurité.
- Personnalisation : Vous pouvez personnaliser l’apparence de la page de paiement pour qu’elle corresponde à votre marque.
Créer une session de paiement
Pour créer une session de paiement, vous devez spécifier les détails du paiement et les URLs de redirection :Fonctionnement de la session de paiement
1
Création de la session
Lorsque vous créez une session, vous envoyez les informations sur les
articles, le montant total, la devise, et les URLs de redirection (pour
succès ou annulation).
2
Redirection vers la page de paiement
Yabetoo fournit une URL vers laquelle vous devez rediriger votre client.
Cette page affiche un formulaire de paiement sécurisé.
3
Traitement du paiement
Le client entre ses informations de paiement sur la page hébergée par
Yabetoo. Une fois le paiement traité, il est redirigé vers votre
success_url ou cancel_url selon le résultat.
Récupérer l’ID du paiement depuis l’URL
Lorsque l’utilisateur est redirigé vers votresuccessUrl, l’ID du paiement est ajouté en tant que paramètre d’URL. Par exemple, si votre successUrl est https://votre-site.com/checkout-success, l’URL redirigée pourrait ressembler à ceci :
Effectuer une double vérification du statut du paiement
Pour renforcer la sécurité, il est recommandé de toujours vérifier le statut du paiement directement via l’API de Yabetoo. Cela vous permet de vous assurer que le paiement a bien été capturé avant de procéder à la livraison du service ou produit à l’utilisateur. Le champ status dans la réponse du paiement peut indiquer plusieurs états, comme succeeded, pending, ou failed. Vous devez vérifier que le statut est bien succeeded avant de finaliser le processus de commande.Il est important de toujours effectuer cette double vérification pour garantir
la sécurité et l’intégrité de votre processus de paiement.
Pourquoi effectuer une double vérification ?
- Sécurité : Cela garantit que le paiement a été réellement effectué et que vous ne traitez pas de fausses transactions.
- Confiance : En ayant une vérification formelle du statut du paiement via l’API, vous conservez une trace fiable des transactions réussies et échouées.
- Prévention des fraudes : En vérifiant le statut du paiement, vous réduisez le risque de fraudes potentielles.