In questo articolo imparerai come collegare il tuo account Mercado Pago per accettare pagamenti all'interno di HITLEAD. Per completare la configurazione, avrai bisogno delle tue credenziali di produzione Mercado Pago e potrebbe essere necessario configurare le notifiche webhook nelle impostazioni sviluppatore di Mercado Pago.

INDICE

Cos'è Mercado Pago?

Mercado Pago è un provider di pagamenti che le aziende possono utilizzare per accettare pagamenti dai clienti, in particolare nei mercati LATAM. HITLEAD si integra con Mercado Pago così le aziende possono collegarlo direttamente all'interno del proprio account, senza dover ricorrere a soluzioni alternative o configurazioni manuali dei pagamenti.

Una volta connesso, puoi gestire il provider da Pagamenti > Integrations e scegliere dove utilizzarlo nei canali di pagamento supportati in HITLEAD.

Principali vantaggi di Mercado Pago

  • Esperienza localizzata: Offri metodi di pagamento già familiari ai tuoi clienti
  • Conversioni migliori: Riduci l'attrito al checkout con provider conosciuti
  • Espansione di mercato: Accedi a un ecosistema di pagamenti LATAM in rapida crescita
  • Maggiore controllo: Decidi come e dove integrare Mercado Pago nel tuo stack di pagamenti

Prerequisiti e requisiti

Una configurazione corretta di Mercado Pago dipende dall'avere le credenziali giuste, le impostazioni dell'account e le informazioni webhook pronte prima di iniziare.

Prima di cominciare, assicurati di avere:

  • Un account Mercado Pago con il supporto CVV/CVC-less abilitato.
  • Accesso alla dashboard sviluppatore di Mercado Pago.
  • L'URL del tuo sito web aziendale, nel caso in cui Mercado Pago lo richieda durante l'abilitazione delle credenziali di produzione.
Nota: I pagamenti reali richiedono credenziali di produzione (non credenziali di test). Le credenziali di produzione sono legate a un'app che crei in Mercado Pago sotto "Your integrations".

Avrai bisogno di questi valori da Mercado Pago:

  • Public Key
  • Access Token
  • Paese dell'account
  • Webhook secret

Schermata 1 — Come integrare Mercado Pago per accettare pagamenti?

Note importanti

  • Usa le credenziali di produzione per i pagamenti reali. Le credenziali di test servono solo per i test e non elaborano transazioni live.
  • Mantieni il tuo Access Token privato e conservalo in modo sicuro.
  • A seconda della configurazione del paese del tuo account Mercado Pago, le opzioni disponibili possono variare. Paesi diversi hanno requisiti minimi diversi — consulta le FAQ per i dettagli.
  • Il tuo account Mercado Pago deve avere il supporto CVV-less abilitato affinché questa integrazione funzioni correttamente.
  • Mercado Pago non consente il lancio di due elementi di checkout sulla stessa pagina: ad esempio, non puoi avere due order form a un singolo step su un Funnel.

Come configurare Mercado Pago

Una configurazione corretta garantisce che HITLEAD possa connettersi a Mercado Pago, instradare correttamente i pagamenti e ricevere gli aggiornamenti degli eventi di pagamento tramite webhook. Completare ogni passaggio con attenzione aiuta a evitare connessioni fallite e problemi di sincronizzazione successivi.

Step 1: Apri Mercado Pago nelle Integrazioni Pagamenti

  1. In HITLEAD, vai a Pagamenti dalla navigazione a sinistra.
  2. Apri la scheda Integrations.
  3. Trova Mercado Pago nell'elenco dei provider e clicca su Connect.

Schermata 2 — Come integrare Mercado Pago per accettare pagamenti?

Step 2: Ottieni le tue credenziali di produzione Mercado Pago

  1. Accedi al tuo account Mercado Pago.

Schermata 3 — Come integrare Mercado Pago per accettare pagamenti?

  1. Apri l'area sviluppatore di Mercado Pago.

Schermata 4 — Come integrare Mercado Pago per accettare pagamenti?

  1. Vai a Your integrations.

Schermata 5 — Come integrare Mercado Pago per accettare pagamenti?

  1. Apri un'applicazione esistente o creane una nuova.

Schermata 6 — Come integrare Mercado Pago per accettare pagamenti?

  1. Vai a Production credentials e copia la Public Key e l'Access Token. Se le credenziali di produzione non sono ancora attive, completa i dettagli aziendali richiesti, come il settore e il sito web.

Schermata 7 — Come integrare Mercado Pago per accettare pagamenti?

Se devi creare una nuova applicazione:

Se non hai ancora un'applicazione in Mercado Pago, creane prima una. In genere, Mercado Pago ti chiederà di:

  1. Inserire un nome per l'applicazione.
  2. Scegliere il tipo di pagamento o il caso d'uso aziendale per i pagamenti online.
  3. Confermare i dettagli della configurazione.
  4. Abilitare le credenziali di produzione e usarle nel passaggio 2.

Step 3: Inserisci le tue credenziali Mercado Pago in HITLEAD

  1. Incolla la Public Key nel campo corrispondente.
  2. Incolla l'Access Token nel campo corrispondente.
  3. Scegli il paese o la regione dell'account corretta.
  4. Genera o inserisci il tuo Webhook Secret nel campo corrispondente.
  5. Clicca su Save o Connect.

Una volta salvato, il tuo account Mercado Pago sarà collegato. Ora abiliteremo i webhook nell'app Mercado Pago.

Schermata 8 — Come integrare Mercado Pago per accettare pagamenti?

Step 4: Configura i webhook in Mercado Pago

Alcune integrazioni Mercado Pago richiedono notifiche webhook affinché gli eventi di pagamento si sincronizzino correttamente con la tua piattaforma. Accedi al tuo account Mercado Pago e vai al pannello sviluppatore. (https://www.mercadopago.com.br/developers/en)

  1. In Mercado Pago, apri l'applicazione usata per l'integrazione e vai a Webhooks.

Schermata 9 — Come integrare Mercado Pago per accettare pagamenti?

  1. Clicca su Configure notifications.

Schermata 10 — Come integrare Mercado Pago per accettare pagamenti?

  1. Completa la configurazione webhook richiesta affinché gli eventi di pagamento si sincronizzino correttamente con HITLEAD.

    • Incolla l'URL webhook nel campo Production mode URL:
    • Aggiungi il Webhook secret uguale a quello inserito nella pagina HITLEAD
    • Seleziona l'evento 'Payment' richiesto per la tua integrazione.
    • Salva le modifiche.

Step 5: Assegna Mercado Pago per canale

Dopo aver connesso l'integrazione, apri Manage Provider Configurations per Mercado Pago in HITLEAD.

  • Passa dalla modalità Live a quella Test secondo le necessità.
  • Assegna Mercado Pago ai canali in cui vuoi renderlo disponibile.

Per ulteriori dettagli sull'assegnazione dei provider di pagamento per canale, consulta Configure Payment Providers by Channel.

Schermata 11 — Come integrare Mercado Pago per accettare pagamenti?

Domande frequenti

D: Ci sono importi minimi nel mio paese?

Sì. Mercado Pago ha regole specifiche sugli importi minimi e massimi di pagamento in base al metodo di pagamento. Se crei un prodotto che non rispetta queste condizioni, il pagamento potrebbe non riuscire. Di seguito i limiti di riferimento attuali supportati da Mercado Pago:

Carte di credito e debito

  • Visa, Mastercard, American Express, Naranja, Cabal e Sucrédito
  • Importo minimo per pagamenti una tantum: $100,00
  • Importo minimo per acquisti a rate: $100,00 per rata
  • Importo massimo: $15.000.000,00

Easy Payment e Rapipago

  • Importo minimo: $100,00
  • Importo massimo: $1.000.000,00

Riferimento: https://www.mercadopago.com.ar/ayuda/monto-minimo-maximo-medios-de-pago_620

D: Cosa succede se creo un prodotto in valuta USD?

Al momento, Mercado Pago non converte dinamicamente la valuta per questa configurazione. Si consiglia di mantenere la valuta del prodotto o servizio uguale alla valuta domestica del tuo account Mercado Pago.

Ad esempio, se il tuo account Mercado Pago è basato in Argentina, dovresti usare il Peso argentino per i prezzi dei tuoi prodotti.

D: Ho aggiunto due elementi di checkout o pagamento al mio Funnel, ma non funzionano

Mercado Pago non lo consente per motivi di sicurezza. Puoi aprire una sola schermata di checkout in una sessione attiva. Per evitare problemi di pagamento, assicurati che il tuo Funnel utilizzi un solo elemento di checkout o pagamento Mercado Pago attivo per volta.

Ad esempio, due o più order form con elemento di acquisizione carta su un singolo Funnel o pagina web non verranno caricati.

D: Cosa succede se il supporto CVV-less non è abilitato sul mio account?

Si consiglia vivamente di abilitare il supporto CVV-less sul tuo account Mercado Pago. Senza di esso, funzionalità come le sottoscrizioni, i pagamenti off-session e la modalità SaaS potrebbero non funzionare correttamente.

D: Quali paesi sono supportati per questa integrazione?

Colombia, Argentina, Cile, Messico, Ecuador, Uruguay, Perù, Brasile, El Salvador

D: Come genero un webhook secret?

Un webhook secret è una stringa casuale ad alta entropia usata per firmare le richieste payload. Può essere una password che riesci a ricordare, ma deve corrispondere sia su HITLEAD che su Mercado Pago. Puoi anche usare un generatore di webhook secret online, che creerà un secret basato sull'algoritmo hmac-sha256 come questo (solo a scopo di esempio): e70fd2ccfed7cf82596fe0494925a0ada87e3b03873a83150bd5458754650211

D: Cos'è l'abilitazione account CVV/CVC-less?

Il CVV o CVC è il codice di sicurezza a 3 o 4 cifre stampato su una carta di credito o debito. Viene comunemente utilizzato per verificare le transazioni online o telefoniche e aiuta a ridurre le frodi.

Nei flussi di pagamento con carta salvata, specialmente quando si addebita un cliente off-session o si avviano sottoscrizioni con una carta già salvata, chiedere al cliente di inserire il CVV ogni volta può creare attrito e aumentare l'abbandono.

Per evitarlo, alcuni provider di pagamento supportano i flussi CVV-less. In questi flussi, la carta viene archiviata in modo sicuro in un modo che consente pagamenti ripetuti più fluidi e una migliore compatibilità con le funzionalità di HITLEAD come sottoscrizioni, pagamenti off-session e flussi di fatturazione SaaS.

Il tuo account Mercado Pago potrebbe avere già questa funzione abilitata, ma dovrai verificarlo con il team di supporto di Mercado Pago. Se non è abilitata, dovrai richiederne l'attivazione.

Articoli correlati

  • Configure Payment Providers by Channel
  • Supported Payment Providers & Methods by Product Area (What Works Where)
  • Payment Links