Aller au contenu principal
Sur cette page

Commencez par Mercado Pago#

Cette page fournit un guide complet pour intégrer Mercado Pago à DEUNA.

Comment ça marche

Mercado Pago vous permet d'offrir à vos clients la possibilité d'enregistrer leur carte pour faciliter les achats futurs.

Mercado Pago tokenizes cartes via API ou widget. DEUNA utilise cette solution pour tokeniser et stocker les cartes dans le coffre.

Il valide que la carte est opérationnelle avant de stocker la carte à Mercado Pago.

Vous pouvez effectuer la validation de deux façons:

  • Auth
  • Charge avec montant minimum

Auth

Le 0 dollar auth la validation consiste à effectuer une charge de validation avec un montant zéro.

Cette opération est disponible uniquement avec Visa et Mastercard pour l'Argentine et le Brésil.

Charge avec montant minimum

Le charge avec montant minimum la validation consiste à effectuer une charge de validation avec un faible montant, qui est remboursé immédiatement.

Cette opération est disponible pour les franchises et les pays où l'auth de Zero dollar n'est pas disponible.

Exigences#

L'obligation d'intégrer Mercado Pago est d'avoir un compte vendeur à Mercado Pago ou Mercado Libre.

Intégrer la pago Mercado

Maintenant que les exigences techniques ont été établies, vous pouvez commencer l'intégration.

1. Activer le webhook Mercado Pago

Pour activer la tokenisation avec Mercado Pago, nous devons d'abord activer la validation du webhook Mercado Pago.

Qu'est-ce que le Webhook

Un webhook est un outil qui facilite la réception des notifications en temps réel chaque fois qu'un événement spécifique se produit.

Pour certifier que Mercado Pago est l'origine de ces notifications, une validation de la requests qui arrivent à notre webhook a été mis en œuvre.

2. Valider le webhook

Mercado Pago nous enverra toujours une clé secrète dans le requests ils envoient à notre webhook, ce qui nous permettra de valider l'origine de celui-ci.

3. Obtenez l'URL webhook

Contactez l'équipe DEUNA pour demander l'URL du site Web Mercado Pago.

4. Configurer le webhook :

Configurer le webhook à partir de la Pago Mercado panneau développeur. Pour ce faire, vous devez faire ce qui suit :

  1. Entrez le panneau développeur et sélectionnez votre intégration.


  2. Dans le menu de gauche, sélectionnez Webhooks.


  3. Cliquez sur Configurer les notifications.

  4. Dans Mode de production, entrez l'url que nous vous avons fourni.

  5. Sélectionnez les événements Payments et Fraud alerts

  6. Cliquez sur Enregistrer la configuration.

5. Obtenez la clé secrète

Dans la section Webhooks, vous devez obtenir votre clé secrète pour fonctionner.

  1. Obtenez la clé secrète en cliquant sur le bouton mot de passe.

  2. Envoyez la clé secrète obtenue à l'équipe DEUNA.

  3. Nous nous occuperons de faire les configurations nécessaires.

6. Activer la tokenisation dans PSP

Une fois que l'équipe DEUNA a confirmé que toutes les configurations nécessaires ont été réalisées avec succès, nous devons activer la tokenisation dans PSP.

  1. Entrez le ADMIN
  2. Allez dans Connexions et recherchez la configuration Mercado Pago
  3. Activer enregistrer les cartes dans PSP case à cocher
  4. Cliquez sur modifier.

7. Vérifier la validation

Lorsque la tokenisation avec Mercado Pago est effectuée correctement:

  1. La réponse arrive de la Créer une carte endpoint.
  2. Le vault.provider attribut a la valeur Mercadopago.
JSON
"vault": {
	"provider": "Mercadopago",
	"id": "id of the vault provider"
}
  1. Le verified_by attribut contient les méthodes de validation possibles.
JSON
"data": {
  "verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}

Observation:#

  • Le external_reference le champ doit satisfaire aux exigences suivantes:
    • Longueur maximale : 64 caractères
    • Caractères autorisés : caractères alphanumériques (lettres et chiffres), tirets (-), et souligne ( )
    • Restriction : Les caractères spéciaux tels que le symbole de hachage (#), les parenthèses, les crochets ou d'autres symboles de ponctuation ne sont pas autorisés.