Paytabs

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, allez dans :

Développeurs → Clés API

Créez une nouvelle clé API.

Après avoir créé la clé API, enregistrez les détails suivants :

• Clé serveur — requis pour la configuration de l’intégration.

• ID de profil — également requis pour la configuration de la connexion.

2. Configurer les notifications de paiement

Allez dans :

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 :

1. Allez dans la Acquisition section

2. Sélectionnez PayTabs comme fournisseur de paiement

3. Saisissez les détails suivants :

   • ID de profil

   • Clé serveur

4. Sélectionnez votre région du compte PayTabs

Veuillez noter ! La région sélectionnée doit correspondre à la région dans laquelle 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 requis
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 — Englishar — Arabicfr — French

La fonction renvoie une URL de paiement.

Si le currency paramètre 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 :

1. Créez un bouton avec le type Paiement type

2. Sélectionnez PayTabs comme fournisseur de paiement

3. Spécifiez :

   • description du paiement ;

   • montant du paiement ;

   • devise.

---

Gestion du statut du paiement

Après 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 Clé serveur

• 100 — le montant du paiement

Pour créer une action pour un paiement réussi, allez dans Builder et créez un bloc avec un déclencheur (cela peut être un bloc Start ou un bloc Trigger ).

Ensuite, dans le champ Trigger saisissez :

• la valeur complète du callback (si vous souhaitez déclencher l’action uniquement pour un montant de paiement spécifique), ou

• seulement la valeur du callback avant le montant du paiement (si vous souhaitez déclencher l’action pour tous les paiements réussis).

Le bloc « Start »

Le bloc « Trigger »

Paiement échoué

Exemple :

SDJ91MTKTT_fail 100

La gestion des paiements échoués est configurée de la même manière que la gestion des paiements réussis.

Créez un bloc avec un déclencheur et saisissez la valeur du callback dans le champ Trigger . Cela vous permet de définir les actions qui seront exécutées lorsqu’un paiement échoue.

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 :

Vrai

Indique que le paiement a été effectué avec succès.