Passa al contenuto principale
In questa pagina

Iniziare con Mercado Pago#

Questa pagina fornisce una guida completa per integrare Mercado Pago con DEUNA.

Come funziona

Mercado Pago ti permette di offrire ai tuoi clienti la possibilità di salvare la loro carta per facilitare gli acquisti futuri.

Mercado Pago getta le carte attraverso API o widget. DEUNA utilizza questa soluzione per gettare e memorizzare le carte nella volta.

Esso convalida che la carta è operativa prima di memorizzare la carta in Mercado Pago.

È possibile eseguire la validazione in due modi:

  • Dollaro zero auth
  • Carica con importo minimo

Dollaro zero auth

Il dollaro zero auth la validazione consiste nell'esecuzione di una carica di convalida con importo zero.

Questa operazione è disponibile solo con Visa e Mastercard per Argentina e Brasile.

Carica con importo minimo

Il carica con importo minimo la validazione consiste nell'effettuare una carica di convalida con un importo basso, che viene rimborsato immediatamente.

Questa operazione è disponibile per franchising e paesi in cui l'autrice di dollaro zero non è disponibile.

Requisiti#

L'esigenza di integrare Mercado Pago è di avere un account venditore in Mercado Pago o Mercado Libre.

Integrazione Mercado Pago

Ora che i requisiti tecnici sono stati stabiliti, è possibile iniziare l'integrazione.

1. Attivare il webhook di Mercado Pago

Per attivare la tokenizzazione con Mercado Pago, dobbiamo prima attivare la convalida di Mercado Pago webhook.

Che cosa è il Webhook

Un webhook è uno strumento che facilita la ricezione delle notifiche in tempo reale ogni volta che si verifica un evento specifico.

Per certificare che Mercado Pago è l'origine di queste notifiche, una validazione della requests che arriva al nostro webhook è stato implementato.

2. Convalida il webhook

Mercado Pago ci manderà sempre una chiave segreta nella requests inviano al nostro webhook, che ci permetterà di convalidare l'origine di esso.

3. Ottenere l'URL webhook

Contatta il team DEUNA per richiedere l'URL di Mercado Pago Webhook.

4. Configurare il webhook:

Configurare il webhook dal Mercado Pago pannello di sviluppo. Per fare questo è necessario fare quanto segue:

  1. Inserisci il pannello sviluppatore e seleziona la tua integrazione.


  2. Nel menu a sinistra, selezionare Webhook.


  3. Clicca su Configurare le notifiche.

  4. In Modalità di produzione, inserire l'url che ti abbiamo fornito.

  5. Selezionare gli eventi Payments e Fraud alerts

  6. Clicca su salvare la configurazione.

5. Ottieni la chiave segreta

Nella sezione webhooks, è necessario ottenere la chiave segreta per operare.

  1. Prendi il chiave segreta facendo clic sul pulsante password.

  2. Invia la chiave segreta ottenuta alla squadra DEUNA.

  3. Ci occuperemo di fare le configurazioni necessarie.

6. Attivare la tokenizzazione in PSP

Una volta che il team DEUNA conferma che tutte le configurazioni necessarie sono state completate con successo, dobbiamo attivare la tokenizzazione in PSP.

  1. Inserisci il ADMIN
  2. Vai a Collegamenti e cerca la configurazione Mercado Pago
  3. Attivare il salva le carte in PSP casella di controllo
  4. Clicca su Modifica.

7. Verificare la convalida

Quando la tokenizzazione con Mercado Pago viene eseguita correttamente:

  1. La risposta arriva dal Creare una carta endpoint.
  2. Il vault.provider attributo ha il valore Mercadopago.
JSON
"vault": {
	"provider": "Mercadopago",
	"id": "id of the vault provider"
}
  1. Il verified_by attribute contiene i possibili metodi di validazione.
JSON
"data": {
  "verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}

Osservazione:#

  • Il external_reference campo deve rispettare i seguenti requisiti:
    • Lunghezza massima: 64 caratteri
    • Caratteri consentiti: caratteri alfabetici (lettere e numeri), trattini (-), e sottolinea ( )
    • Limite: Non sono ammessi caratteri speciali come il simbolo hash (#), parentesi, parentesi o altri simboli di punteggiatura.