# Bepaid ## **Comment se connecter** Pour connecter le **bePaid** système de paiement, vous aurez besoin d’un **ID du magasin**, **clé secrète**, et **clé publique**. Une fois ces identifiants reçus, allez dans les paramètres de **Salebot**. {% hint style="info" %} Pour obtenir la **ID du magasin**, **clé secrète**, et **clé publique**, veuillez contacter **baPaid** l’assistance technique pour obtenir de l’aide. {% endhint %} Dans **MaviBot**, ouvrez la section **« Système de paiement »** et sélectionnez **bePaid**. Ensuite, saisissez les identifiants que vous avez reçus.

Veuillez noter que le dernier champ est un interrupteur qui sélectionne l’hébergement de l’API selon le pays d’utilisation : **Biélorussie** ou **Russie**.

## **Comment générer un lien de paiement** Pour générer un lien de paiement, vous devez définir une valeur pour la variable **payment\_sum** (par exemple : **150** ou **100.55** — utilisez un point comme séparateur décimal). Une fois la variable **payment\_sum** définie, la variable **bepaid\_pay\_url** apparaîtra automatiquement. Vous pouvez afficher cette variable à l’écran sous forme de lien ou la placer sur un bouton avec le texte **« Payer »**. Le lien de paiement ressemblera à ceci :\ Avant de définir la variable **payment\_sum** vous pouvez également définir les variables facultatives suivantes pour personnaliser le paiement. {% hint style="info" %} Par défaut, la devise est définie sur **rouble biélorusse**. Si vous devez utiliser une autre devise, définissez une valeur pour la variable **currency** . {% endhint %}

Paramètres de la fonction	Description	Plus d’informations
currency	Devise de paiement au format ISO 4217	Par exemple : USD
language	Langue de la page de paiement Par défaut : en.	Valeurs autorisées : en – anglais es – espagnol tr – turc de – allemand it – italien ru – russe zh – chinois fr – français da – danois sv – suédois no – norvégien fi – finnois pl – polonais ja – japonais uk – ukrainien be – biélorusse ka – géorgien ro – roumain
payment_description	Description du paiement
link_expired	Expiration du lien de paiement Définissez la date d’expiration au format jj.mm.aaaa (par exemple : 25.06.2025). Par défaut, le paiement doit être effectué dans les 24 heures.	Vous pouvez également utiliser le champ « Assign Variables on Redirect » pour définir : `link_expired = current_date + 2` — le lien sera valide pendant 2 jours jusqu’à 00:00. Vous pouvez également spécifier une date et une heure d’expiration exactes au format jj.mm.aaaa hh:mm (par exemple : 25.06.2025 12:23). Par défaut, le paiement doit être effectué dans les 24 heures. Des variables standard peuvent également être utilisées. Par exemple, pour définir la validité du lien à 30 minutes : time = current_time + 30 link_expired = "#{current_date} #{time}"
russian_host	Indicateur pour un magasin enregistré sur l’hôte russe de bePaid Définissez ce paramètre sur 1 si votre magasin est enregistré sur bepaid.tech.	Si vous devez basculer l’hôte vers la Biélorussie, définissez ce paramètre sur "" (valeur vide).
test_payments	Cette variable est utilisée pour les paiements de test. Pour effectuer un paiement de test, ajoutez-la avec n’importe quelle valeur.
bepaid_attempts	Spécifie le nombre de tentatives de paiement. Par défaut, 1 tentative est autorisée.
сustomer_data	Un tableau contenant le prénom, nom, et e-maildu payeur. Ces données sont requises pour envoyer le reçu à l’e-mail du payeur et peuvent être modifiées sur la page de paiement.	Le paramètre doit être transmis sous forme de liste de paires clé-valeur au format JSON. Par exemple : customer_data = ‘{“first_name”: “Sam”, “last_name”: “Smith”, “email”: “sam_smith@mavibot.ai” }’
bepaid_contract (conditionnellement requis)	Objet du paiement par jeton	Valeurs attendues : « recurring » – pour les paiements réguliers à fréquence définie « card_on_file » – pour les paiements ponctuels ou irréguliers, par ex. paiement après prestation d’un service

Une fois le paiement effectué, la variable **bepaid\_callback\_data** sera ajoutée pour le client. Elle contient la réponse du système de paiement pour la transaction terminée. Vous pouvez extraire les données requises de ce dictionnaire à l’aide de la méthode **get** . ## **Comment tester les paiements** Pour effectuer un paiement de test, avant de définir la variable **payment\_sum** définissez la variable **test\_payments** avec n’importe quelle valeur.\ N’oubliez pas de la supprimer lorsque vous lancez le bot en **mode réel**! **Cartes de test :** * 4200000000000000 — succès * 4005550000000019 — échec Si quelque chose ne fonctionne pas, comparez vos données avec la documentation officielle : ## **Exemple de génération d’un lien de paiement** Créons un lien de paiement pour **100 roubles biélorusses** (devise par défaut). Remarque : commencez par définir les variables supplémentaires de configuration, puis définissez **payment\_sum**. Les variables peuvent également être définies plus tôt dans le workflow, pas nécessairement dans le même bloc — ceci n’est qu’un exemple. Enfin, affichez la variable **bepaid\_pay\_url** à l’emplacement souhaité ; elle contient le lien de paiement généré. ## **Gestion des abonnements** L’intégration du système de paiement vous permet de créer des abonnements pour vos clients. Avant d’utiliser cette fonctionnalité dans **Salebot**, créez un plan d’abonnement dans votre compte **bePaid** . {% hint style="warning" %} Si le **« Plans »** et **« Subscriptions »** les menus n’apparaissent pas dans votre compte, veuillez contacter votre responsable. {% endhint %} **Création d’un abonnement et génération d’un lien de paiement** Utilisez la fonction **get\_bepaid\_subscription\_url** en passant le paramètre **plan\_id** où…


plan_id	plan_id est l’identifiant du plan dans le système bePaid .

En conséquence, la fonction créera un abonnement et renverra un lien de paiement. Envoyez le lien au client et attendez que le paiement soit effectué. Une fois le paiement réussi, l’abonnement sera activé. L’affaire recevra les variables **bepaid\_subscription\_id** et **bepaid\_subscription\_status** et un callback sera envoyé au bot (voir la section **« Comment traiter le résultat »** ). ## **Récupération des informations d’abonnement** Pour obtenir les détails actuels de l’abonnement d’un client, appelez la fonction **get\_bepaid\_subscription\_info** et transmettez le paramètre **subscription\_id** (la valeur peut être prise à partir de la variable **bepaid\_subscription\_id** ). ## **Annulation d’un abonnement** Pour annuler un abonnement, utilisez **cancel\_bepaid\_subscription** fonction. Cette fonction accepte un seul paramètre : **subscription\_id** (la valeur peut être prise à partir de la variable **bepaid\_subscription\_id** ). En cas d’annulation réussie, la variable **bepaid\_subscription\_status** sera définie sur **« canceled »**, et un callback sera envoyé au bot (voir la section **« Comment traiter le résultat »** ). ## Statuts des abonnements


trial	Actif ou annulé période d’essai de l’abonnement.
active	Abonnement actif avec paiement effectué à temps.
failed	Abonnement en échec. bePaid n’a pas pu traiter le paiement suivant.
error	Une erreur s’est produite lors de bePaid tentait de traiter le paiement.
canceled	L’abonnement a été canceled et n’est plus actif.

## **Paiements récurrents** Vous pouvez également mettre en place un système d’abonnement **sans créer de plan** dans votre **bePaid** . Pour cela, vous aurez besoin du **jeton de carte**. du client. Pour obtenir le jeton de carte, le client doit effectuer un paiement initial à l’aide d’un lien généré via **payment\_sum**. Avant de définir la variable **payment\_sum** valeur, définissez la **bepaid\_contract** variable pour préciser l’objet des futurs paiements par jeton : * **« recurring »** – pour les paiements réguliers à fréquence définie * **« card\_on\_file »** – pour les paiements ponctuels ou irréguliers, par ex. paiement après prestation d’un service {% hint style="warning" %} Le **« card\_on\_file »** n’est pas pris en charge par tous les acquéreurs. Si vous souhaitez l’utiliser, veuillez contacter votre gestionnaire de compte. {% endhint %} Après un paiement réussi, la variable **bepaid\_client\_card\_token** sera ajoutée à l’affaire, stockant le jeton de carte du client. Ce jeton vous permet de débiter la carte du client **sans son intervention**. Ensuite, configurez votre tunnel et indiquez une date ou une condition pour le débit automatique, puis appelez la fonction **make\_bepaid\_token\_payment** en transmettant les paramètres requis. Ordre des paramètres :\ **amount → currency → description → contract** ### Descriptions des paramètres


amount (requis)	Montant du paiement – la valeur attendue est un entier ou nombre décimal, par exemple : 100 ou 100.5.
currency (requis)	Devise du paiement au format ISO 4217 , par exemple : « USD ».
description (requis)	Description du débit, par exemple : « Paiement hebdomadaire de l’abonnement pour la participation au club de loisirs ».
contract (requis)	Objet du paiement par jeton. Valeurs attendues : « recurring » ou « card_on_file ».

{% hint style="warning" %} Le **contract** la valeur doit **correspondre exactement** à la valeur spécifiée lors de la création du lien de paiement initial ! {% endhint %} Si le paiement réussit, la fonction renverra le message **« Débit réussi via le jeton bePaid »**, vous recevrez un callback pour le paiement réussi, et la variable de l’affaire **bepaid\_token\_payment\_completed** sera définie sur **« True »**. Si le paiement échoue, la fonction renverra un message indiquant la raison de l’échec, un callback avec le suffixe **« \_fail »** sera envoyé au bot, et la variable de l’affaire **bepaid\_token\_payment\_completed** sera définie sur **« False »**. {% hint style="warning" %} La banque peut exiger que le client finalise le paiement. Dans ce cas, la fonction renverra un lien invitant le client à passer par **l’authentification 3-D Secure**. {% endhint %} ## **Comment traiter le résultat** En réponse aux actions du client, le bot recevra des callbacks composés des **20 premiers caractères de la clé secrète** et d’un suffixe, qui dépend du type et du résultat de l’opération. Dans le système, le callback apparaît comme un message de l’utilisateur, mais l’utilisateur **ne le voit pas**. ### **Pour les paiements** Pour les paiements **sans lien avec les abonnements**, vous recevrez l’un des messages suivants : * **keyNumber\_success** – pour un paiement réussi * **keyNumber\_fail** – pour un paiement échoué Vous pouvez également suivre le statut du dernier paiement à l’aide des variables : * **bepaid\_payment\_completed** – pour les paiements impliquant le client * **bepaid\_token\_payment\_completed** – pour **les paiements automatiques par jeton de carte** ### **Pour les abonnements** Après l’activation réussie d’un abonnement, que ce soit lors du premier paiement ou d’un paiement récurrent, le bot recevra le message **keyNumber\_success**. Si l’abonnement est annulé, vous recevrez **keyNumber\_canceled**. En cas d’échec du paiement d’un abonnement, le message **keyNumber\_fail** sera envoyé. --- # 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/bepaid.md?ask= ``` 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.