Pour utiliser PagBank comme fournisseur de paiement dans Mavibot, vous devez obtenir un jeton d'accès depuis votre compte PagBank et le saisir dans les paramètres de paiement.

Obtenir un jeton

Environnement de production : connectez-vous à votre compte PagBank depuis un ordinateur, allez dans Vendas → Integrações (Ventes → Intégrations), puis cliquez sur Gerar token (Générer un jeton).

Environnement de test (bac à sable) : connectez-vous au portail développeur PagBank, ouvrez l'onglet Tokens, et copiez votre jeton de bac à sable.

Le jeton n'est affiché qu'une seule fois. Conservez-le dans un endroit sécurisé : si vous le perdez, vous devrez en générer un nouveau, et l'ancien jeton cessera de fonctionner.

Vous n'avez pas besoin de configurer une URL de notification de paiement dans votre compte PagBank — Mavibot la fournit automatiquement lors de la création de chaque paiement.

Configuration

Dans les paramètres du système de paiement, sélectionnez PagBank et saisissez :

  • Jeton — le jeton d'accès API de votre compte PagBank.
  • Mode test — activez cette option si vous avez saisi un jeton de bac à sable. En mode test, les requêtes sont envoyées à sandbox.api.pagseguro.com, et aucun argent réel n'est débité.

La configuration est terminée.

Créer un lien de paiement

Fonction de la calculatrice :

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

Paramètres

Paramètre Description
amount Montant du paiement. Obligatoire. Minimum : 1 BRL ; maximum : 9 999 999 BRL. Saisissez le montant comme 100.55, pas 10055.
description Description du paiement. Facultative, jusqu'à 255 caractères. Le client la verra sur la page de paiement.
product_name Nom du produit, jusqu'à 100 caractères. Facultatif ; description est utilisé par défaut.
customer_email Adresse e-mail du client. Facultative ; pré-remplie sur la page de paiement.
customer_phone Numéro de téléphone du client. Facultatif ; pré-rempli sur la page de paiement. PagBank n'accepte que les numéros de téléphone mobile brésiliens : indicatif pays 55, un indicatif régional à deux chiffres et un numéro à neuf chiffres commençant par 9 (par exemple, +55 11 99999-8888).
full_name Prénom et nom du client. Facultatif ; pré-rempli sur la page de paiement.
identity_number CPF du client (11 chiffres) ou CNPJ (14 chiffres). Facultatif ; pré-rempli sur la page de paiement.

La fonction renvoie une URL de paiement.

PagBank n'accepte les informations du client que sous forme d'un ensemble complet : le nom, l'e-mail, le numéro de téléphone et le CPF/CNPJ doivent tous être fournis. Si l'un de ces quatre champs est manquant, ou si le numéro de téléphone n'est pas un numéro de mobile brésilien valide, Mavibot n'enverra aucune information client à PagBank. Le client les remplira simplement sur la page de paiement. Cela n'affecte pas le paiement lui-même.

Lien de paiement dans un bouton

Pour envoyer un bouton avec un lien de paiement, sélectionnez le type de bouton de paiement et choisissez PagBank comme système de paiement. Saisissez le nom du produit et le montant du paiement. 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 après paiement

Après que le client a suivi le lien et effectué le paiement, un rappel de paiement réussi sera envoyé à la boîte de dialogue :

A1B2C3D4E5_success 100.55

Ici, A1B2C3D4E5 correspond aux 10 premiers caractères de votre jeton, et 100.55 est le montant du paiement.

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

A1B2C3D4E5_fail 100.55

Un rappel d'échec est envoyé uniquement lorsque le lien de paiement ne peut plus être utilisé : la banque a définitivement refusé ou annulé le paiement, ou le lien de paiement a expiré. Aucun rappel n'est envoyé pendant que le paiement est en cours d'examen, en attente de paiement par boleto, ou autorisé mais toujours en attente sur la carte, car le lien de paiement reste actif. Un lien de paiement expiré n'a pas de paiement associé, donc le rappel n'inclura pas de montant.

Pour gérer un paiement réussi ou échoué, suivez ces étapes :

  1. Créez un bloc avec un déclencheur (un bloc Déclencheur gris ou un bloc Démarrer vert — utilisez le bloc vert si vous souhaitez continuer à construire l'entonnoir après le paiement).
  2. Dans le champ Déclencheur, saisissez le rappel sans le montant du paiement :
A1B2C3D4E5_success

Utilisez cette option si vous souhaitez que le bloc réagisse à chaque paiement réussi.

Définissez le type de correspondance sur Correspondance par mot-clé.

Alternativement, saisissez le rappel complet :

A1B2C3D4E5_success 100.55

Utilisez cette option si vous souhaitez que le bloc réagisse uniquement à un paiement pour un montant spécifique.

Définissez le type de correspondance sur Correspondance exacte.

Variables client après un paiement réussi

Variable Valeur
pagbank_callback_data Informations de paiement reçues du système de paiement
pagbank_payment_completed "True" — le paiement a été traité avec succès
pagbank_order_id ID de commande PagBank (ORDE_…)
pagbank_charge_id ID de charge PagBank (CHAR_…)
pagbank_payment_method Méthode de paiement : CREDIT_CARD, DEBIT_CARD, PIX, ou BOLETO