Pour utiliser Clip dans MaviBot, vous devez créer une paire d'identifiants dans votre compte Clip et les saisir dans les paramètres du système de paiement.

Clip est un service de paiement mexicain.

Obtention des identifiants

Signez un accord avec Clip et accédez au Tableau de bord développeur dans votre compte Clip.

Dans la section des identifiants, cliquez sur Crear credencial (Créer des identifiants), saisissez un nom et confirmez la création.

Copiez les identifiants suivants :

Clé API
Clave secreta (Clé secrète)

Important ! La clé secrète n'est affichée qu'une seule fois, immédiatement après la création des identifiants. Enregistrez-la dans un endroit sécurisé. Vous ne pouvez pas la revoir dans votre compte Clip. Si vous la perdez, vous devrez créer une nouvelle paire d'identifiants.

Les identifiants sont créés séparément pour les environnements de production et de test. Vous pouvez créer jusqu'à 6 applications par compte.

Pour les tests d'intégration, créez une paire d'identifiants de test. Pour accepter des paiements réels, utilisez les identifiants de production.

Vous n'avez pas besoin de configurer une URL de notification de paiement dans votre compte Clip. MaviBot envoie automatiquement l'URL de notification lors de la création de chaque paiement.

Connexion de Clip

Dans l'onglet Acquiring, sélectionnez Clip et saisissez :

Champ	Description
Clé API	Identifiant de l'application.
Clé secrète (Clave secreta)	Clé secrète de l'application.

La connexion est maintenant terminée.

Génération d'un lien de paiement

Utilisez la fonction Calculatrice suivante :

get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)

Paramètres

Paramètre	Description
`amount`	Montant du paiement. Obligatoire. Le montant minimum est `1` dans l'unité monétaire principale. Spécifiez le montant comme `100.55`, pas `10055`.
`description`	Description du paiement. Optionnelle. Longueur maximale : 250 caractères. Le client peut la voir sur la page de paiement et le reçu.
`currency`	Code monétaire à trois lettres (`MXN` et autres devises disponibles pour votre compte Clip). Optionnel. Par défaut : `MXN`.
`customer_email`	Adresse e-mail du client. Optionnelle. Insérée automatiquement dans le formulaire de paiement.
`customer_phone`	Numéro de téléphone du client. Optionnel. Inséré automatiquement dans le formulaire de paiement.
`full_name`	Nom du client. Optionnel. Inséré automatiquement dans le formulaire de paiement.
`product_name`	Nom du produit. Optionnel.
`language`	Langue de la page de paiement : `es` pour l'espagnol (par défaut) ou `en` pour l'anglais.

La fonction renvoie une URL de paiement.

Bouton de lien de paiement

Pour envoyer un bouton de paiement au client :

Créez un bouton avec la fonction Payer.
Sélectionnez Clip comme système de paiement.
Spécifiez le nom du produit, le montant et la devise.
Si nécessaire, spécifiez les variables contenant le nom, l'adresse e-mail et le numéro de téléphone du client.

Rappels de paiement

Après que le client a suivi le lien de paiement et effectué le paiement, MaviBot reçoit un rappel.

Paiement réussi

Exemple :

SDJ91MTKTT_success 100.55

Où :

SDJ91MTKTT — les 10 premiers caractères de votre clé API.
100.55 — le montant du paiement.

Paiement échoué

Si le paiement échoue, le rappel suivant est envoyé :

SDJ91MTKTT_fail 100.55

Important ! Un rappel de paiement échoué est envoyé uniquement après la fermeture définitive du lien de paiement : après 5 tentatives de paiement infructueuses ou à l'expiration du lien.

Tant que le client a encore des tentatives de paiement disponibles, le lien reste actif et aucun rappel de paiement échoué n'est envoyé.

Variables client après un paiement réussi

Variable	Description
`clip_callback_data`	Informations de paiement reçues du système de paiement Clip.
`clip_payment_completed`	`"True"` si le paiement a été traité avec succès.
`clip_payment_request_id`	Identifiant du lien de paiement dans Clip.
`clip_receipt_no`	Numéro de reçu Clip.