Connexion de PayTabs à Mavibot
Pour connecter PayTabs à Mavibot, vous devez configurer plusieurs paramètres dans votre compte PayTabs.
1. Créer une clé API
Dans votre tableau de bord PayTabs, accédez à :
Développeurs → Clés API
Créez une nouvelle clé API.
Après avoir créé la clé API, enregistrez les informations suivantes :
- Clé serveur — requise pour configurer l'intégration.
- ID de profil — également requis pour la configuration de la connexion.
2. Configurer les notifications de paiement
Accédez à :
Développeurs → Configuration
Activez les notifications de paiement (callbacks).
Cliquez sur "+" et ajoutez l'URL de callback suivante :
https://chatter.mavibot.ai/paytabs_callback/result
Cette URL est utilisée pour envoyer les mises à jour du statut de paiement à Mavibot.
3. Configurer PayTabs dans Mavibot
Dans les paramètres de Mavibot :
- Accédez à la section Acquiring
- Sélectionnez PayTabs comme fournisseur de paiement
- Saisissez les informations suivantes :
- ID de profil
- Clé serveur
- Sélectionnez la région de votre compte PayTabs
Veuillez noter !
La région sélectionnée doit correspondre à la région où votre compte PayTabs est enregistré.
Une fois les paramètres enregistrés, la configuration de l'intégration sera terminée.
Génération d'un lien de paiement
Pour générer un lien de paiement, utilisez la fonction suivante :
get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)
Paramètres de la fonction
| Paramètre | Description |
|---|---|
| ! amount | Montant du paiement. Paramètre obligatoire |
| description | Description du paiement. Paramètre facultatif |
| currency | Devise du paiement. Paramètre facultatif |
| customer_email | Adresse e-mail du client. Paramètre facultatif |
| customer_phone | Numéro de téléphone du client. Paramètre facultatif |
| full_name | Nom complet du client. Paramètre facultatif |
| language | Langue de la page de paiement. Paramètre facultatif |
Devises disponibles
Les codes de devise suivants sont pris en charge :
SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD
Langues disponibles
en — Anglaisar — Arabe
fr — Français
La fonction renvoie une URL de paiement.
Si le paramètre currency n'est pas fourni, la devise sera automatiquement sélectionnée en fonction de la région configurée.
Utilisation du lien de paiement dans un bouton
Pour envoyer un bouton de paiement à un client :
- Créez un bouton de type Paiement
- Sélectionnez PayTabs comme fournisseur de paiement
- Spécifiez :
- la description du paiement ;
- le montant du paiement ;
- la devise.
Gestion du statut de paiement
Une fois que le client a ouvert le lien de paiement et effectué le paiement, un événement de callback sera envoyé à la conversation.
Paiement réussi
Exemple :
SDJ91MTKTT_success 100
Où :
- SDJ91MTKTT — les 10 premiers caractères de la Clé serveur
- 100 — le montant du paiement
Pour créer une action pour un paiement réussi, accédez à Builder et créez un bloc avec un déclencheur (il peut s'agir d'un bloc Début ou d'un bloc Déclencheur).
Ensuite, dans le champ Déclencheur, saisissez :
- la valeur complète du callback (si vous souhaitez déclencher l'action uniquement pour un montant de paiement spécifique), ou
- uniquement la valeur du callback avant le montant du paiement (si vous souhaitez déclencher l'action pour tous les paiements réussis).
Paiement échoué
Exemple :
SDJ91MTKTT_fail 100
La gestion des paiements échoués est configurée de la même manière que celle des paiements réussis.
Créez un bloc avec un déclencheur et saisissez la valeur du callback dans le champ Déclencheur. Cela vous permet de définir des actions qui seront exécutées en cas d'échec d'un paiement.
Variables enregistrées après un paiement réussi
Après un paiement réussi, les variables suivantes sont automatiquement enregistrées pour le client :
paytabs_callback_data
Contient la charge utile complète du webhook reçue du système de paiement.
paytabs_payment_completed
Valeur :
True
Indique que le paiement a été effectué avec succès.