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.

Pour obtenir la ID du magasin, clé secrète, et clé publique, veuillez contacter baPaid l’assistance technique pour obtenir de l’aide.

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 : https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a

Avant de définir la variable payment_sum vous pouvez également définir les variables facultatives suivantes pour personnaliser le paiement.

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 .

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”: “[email protected]” }’
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 : https://docs.bepaid.by/ru/test-integration#test-card-number

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 .

Si le « Plans » et « Subscriptions » les menus n’apparaissent pas dans votre compte, veuillez contacter votre responsable.

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

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.

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

Le contract la valeur doit correspondre exactement à la valeur spécifiée lors de la création du lien de paiement initial !

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

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.

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