Mercado Pago
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:
-
Inserisci il pannello sviluppatore e seleziona la tua integrazione.
-
Nel menu a sinistra, selezionare Webhook.
-
Clicca su Configurare le notifiche.
-
In Modalità di produzione, inserire l'url che ti abbiamo fornito.
-
Selezionare gli eventi
PaymentseFraud alerts -
Clicca su salvare la configurazione.
5. Ottieni la chiave segreta
Nella sezione webhooks, è necessario ottenere la chiave segreta per operare.
-
Prendi il chiave segreta facendo clic sul pulsante password.
-
Invia la chiave segreta ottenuta alla squadra DEUNA.
-
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.
- Inserisci il ADMIN
- Vai a Collegamenti e cerca la configurazione Mercado Pago
- Attivare il salva le carte in PSP casella di controllo
- Clicca su Modifica.
7. Verificare la convalida
Quando la tokenizzazione con Mercado Pago viene eseguita correttamente:
- La risposta arriva dal Creare una carta endpoint.
- Il
vault.providerattributo ha il valoreMercadopago.
"vault": {
"provider": "Mercadopago",
"id": "id of the vault provider"
}- Il
verified_byattribute contiene i possibili metodi di validazione.
"data": {
"verified_by": "mercadopago_minimum_amount" or "mercadopago_zero_dollar_auth"
}
Osservazione:#
- Il
external_referencecampo 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.