# 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.

<div data-with-frame="true"><img src="/files/b25ac85e91554f2c5d58f5a3dae9342303306679" alt=""></div>

<div data-with-frame="true"><img src="/files/3d779438903adae38a09b43e90b26cad935b6f0c" alt=""></div>

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.

<div data-with-frame="true"><img src="/files/e0133279ae3ea5ff82bec06a4046c67288d5f1d1" alt="" height="252" width="794"></div>

### 2. Configurer les notifications de paiement

Allez dans :

**Développeurs → Configuration**

<div data-with-frame="true"><img src="/files/033d508542dbdf3614980f29a0e9e6772f48c58b" alt="" height="414" width="750"></div>

Activez les notifications de paiement (**callbacks**).

Cliquez sur **"+"** et ajoutez l’URL de callback suivante :

```
https://chatter.mavibot.ai/paytabs_callback/result
```

<div data-with-frame="true"><img src="/files/dcee678040409c8d9948de64e80d446c0b106ff2" alt="" height="322" width="822"></div>

<div data-with-frame="true"><img src="/files/c4d04f2a2ff9328ea2cd3e6fd55a70735cd1d527" alt="" height="368" width="835"></div>

Cette URL est utilisée pour envoyer les mises à jour du statut de paiement à Mavibot.

### 3. Configurer PayTabs dans Mavibot

<div data-with-frame="true"><figure><img src="/files/f4f4cb85b19d02bb20a293cd2da226277941e22e" alt=""><figcaption></figcaption></figure></div>

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**

{% hint style="info" %}
**Veuillez noter !**\
La région sélectionnée doit correspondre à la région dans laquelle votre compte PayTabs est enregistré.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/4fdcc6e5f4c8a4c624068457e6245c18cadbe243" alt="" width="563"><figcaption></figcaption></figure></div>

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                                         |
| ------------------------------------------------ | --------------------------------------------------- |
| <mark style="color:$danger;">**!**</mark> 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.

<div data-with-frame="true"><img src="/files/1c6595e91203e6c6a872eb0f1a993af83c415b13" alt="" width="554"></div>

***

## 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

<div data-with-frame="true"><figure><img src="/files/7eb9ce2db031dcc5add5ed66c565d27190b8ca75" alt="" width="357"><figcaption></figcaption></figure></div>

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).

<div data-with-frame="true"><figure><img src="/files/0759eec22fc6e32cb307ab3466a1b957625e5115" alt=""><figcaption><p>Le bloc « Start »</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/7f8d979380fd81e18c55bd7472f62631ddef7fef" alt=""><figcaption><p>Le bloc « Trigger »</p></figcaption></figure></div>

### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/integrations/payment/paytabs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.