Connexion de Telr
Pour utiliser le système de paiement Telr dans MaviBot, vous devez obtenir les identifiants de votre boutique depuis votre compte Telr et les saisir dans les paramètres du système de paiement.
Obtention des identifiants de la boutique
Signez un accord avec Telr et accédez à votre compte marchand.
Dans Boutiques → Détails de la boutique, copiez les valeurs suivantes :
| Champ Telr | Champ MaviBot |
|---|---|
| Store ID | Store ID |
| Authentication key | Authentication Key |
Configuration des notifications de paiement
Ouvrez Page de paiement (ou Sécurité) → Transaction advice et spécifiez l'URL de notification suivante :
https://chatter.mavibot.ai/telr_callback/result
Sélectionnez les types de transactions pour lesquels vous souhaitez recevoir des notifications.
Dans la même section, copiez la Secret key. Cette clé est utilisée pour vérifier les signatures des notifications.
Important ! La configuration de Transaction advice est obligatoire. Sans elle, MaviBot ne recevra pas les notifications de paiement et aucun callback ne sera envoyé au bot.
Connexion de Telr dans MaviBot
Ouvrez Systèmes de paiement dans les paramètres de votre projet, sélectionnez Telr et remplissez les champs suivants :
| Champ | Description |
|---|---|
| Store ID | Identifiant numérique de votre boutique Telr. |
| Authentication Key | Utilisée pour générer les liens de paiement. |
| Secret Key | Utilisée pour vérifier les signatures des notifications de paiement. Sans elle, les notifications de paiement seront rejetées. |
| Test Mode | Active les paiements de test avec les cartes de test Telr sans débiter de fonds réels. Désactivez cette option pour accepter les paiements réels. |
Une fois tous les champs remplis, l'intégration est prête à être utilisée.
Génération d'un lien de paiement
Utilisez la fonction suivante de la Calculatrice :
get_telr_payment_url(amount, description, currency, product_name)
Paramètres
| Paramètre | Description |
|---|---|
amount |
Montant du paiement. Obligatoire. |
description |
Description du paiement. Optionnelle. Longueur maximale : 63 caractères. |
currency |
Code de devise à trois lettres (AED, SAR, USD, EUR, GBP et autres devises disponibles pour votre compte Telr). Optionnel. Par défaut : AED. |
product_name |
Nom du produit. Optionnel. |
La fonction renvoie une URL de paiement.
Important ! Les liens de paiement restent valides pendant une durée limitée. Envoyez le lien au client immédiatement après sa génération.
Exemple
Bouton de lien de paiement
Pour envoyer un bouton de paiement :
- Créez un bouton avec la fonction Payer.
- Sélectionnez Telr comme système de paiement.
- Spécifiez :
- Nom du produit
- Montant du paiement
- Devise
Callbacks de paiement
Une fois que le client a effectué le paiement, MaviBot reçoit automatiquement un callback.
Paiement réussi
Exemple :
SDJ91MTKTT_success 100
Où :
-
SDJ91MTKTT— les 10 premiers caractères de votre Authentication Key. -
100— le montant du paiement.
Paiement échoué ou annulé
Exemple :
SDJ91MTKTT_fail 100
Paiement en attente d'examen bancaire
Si un paiement est autorisé mais mis en attente par la banque pour une vérification supplémentaire, aucun callback n'est envoyé tant que l'examen n'est pas terminé.
Une fois que la banque approuve ou refuse la transaction, Telr envoie une notification et le callback est livré automatiquement à MaviBot.
Variables client après un paiement réussi
| Variable | Description |
|---|---|
telr_callback_data |
Informations de paiement reçues du système de paiement Telr. |
telr_payment_completed |
"True" si le paiement a été traité avec succès. |
telr_tran_ref |
Référence de transaction Telr (tran_ref). |