In questo articolo scoprirai come collegare il tuo account Mercado Pago per accettare pagamenti all'interno di GoHighLevel / Squadd. Per completare la configurazione avrai bisogno delle credenziali di produzione di Mercado Pago e potrebbe essere necessario configurare le notifiche webhook nelle impostazioni sviluppatore di Mercado Pago.
Cos'è Mercado Pago?
Mercado Pago è un provider di pagamenti che le aziende possono utilizzare per accettare pagamenti dai clienti, in particolare nei mercati LATAM. GoHighLevel / Squadd si integra con Mercado Pago in modo che le aziende possano collegarlo direttamente all'interno del proprio account, senza ricorrere a soluzioni alternative o configurazioni manuali dei pagamenti.
Una volta connesso, le aziende possono gestire il provider da Pagamenti > Integrazioni e scegliere dove utilizzarlo nei canali di pagamento supportati in GoHighLevel / Squadd.
Principali vantaggi di Mercado Pago
- Esperienza localizzata: Offri metodi di pagamento già conosciuti e di fiducia per i tuoi clienti
- Migliori conversioni: Riduci l'attrito al checkout con provider familiari
- Espansione di mercato: Accedi a un ecosistema di pagamenti LATAM in rapida crescita
- Maggiore controllo: Decidi come e dove Mercado Pago si inserisce nel tuo stack di pagamenti
Prerequisiti e requisiti
Una configurazione corretta di Mercado Pago dipende dall'avere a disposizione le credenziali giuste, le impostazioni dell'account e le informazioni sui webhook prima di iniziare.
Prima di iniziare, 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'attivazione delle credenziali di produzione.
Nota: I pagamenti reali richiedono credenziali di produzione (non credenziali di test). Le credenziali di produzione sono associate a un'app che crei in Mercado Pago sotto Le tue integrazioni.
Avrai bisogno di questi valori da Mercado Pago:
Public Key
Access Token
Paese dell'account
Webhook secret
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 nel 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 di avviare due elementi di checkout sulla stessa pagina; ad esempio, non è possibile mantenere due order form a uno step sullo stesso Funnel.
Come configurare Mercado Pago
Una configurazione corretta garantisce che GoHighLevel / Squadd possa connettersi a Mercado Pago, instradare i pagamenti correttamente e ricevere aggiornamenti sugli eventi di pagamento tramite webhook. Completare ogni passaggio con attenzione aiuta a evitare connessioni fallite e problemi di sincronizzazione in seguito.
Passaggio 1: Apri Mercado Pago nelle Integrazioni pagamenti
In GoHighLevel / Squadd, vai su Pagamenti dal menu di navigazione a sinistra.
Apri la scheda Integrazioni.
Trova Mercado Pago nell'elenco dei provider e clicca su Connetti.
Passaggio 2: Ottieni le credenziali di produzione di Mercado Pago
Accedi al tuo account Mercado Pago.
Apri l'area sviluppatori di Mercado Pago.
Vai su Le tue integrazioni.
Apri un'applicazione esistente o creane una nuova.
Vai su Credenziali di produzione 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.
Se devi creare una nuova applicazione:
Se non hai ancora un'applicazione all'interno di Mercado Pago, creane una prima. Nella maggior parte dei casi, Mercado Pago ti chiederà di:
Inserire il nome dell'applicazione.
Scegliere il tipo di pagamento o il caso d'uso aziendale per i pagamenti online.
Confermare i dettagli della configurazione.
Abilitare le credenziali di produzione e utilizzarle nel passaggio 2.
Passaggio 3: Inserisci le credenziali di Mercado Pago in GoHighLevel / Squadd
Incolla la Public Key nel campo corrispondente.
Incolla l'Access Token nel campo corrispondente.
Scegli il paese o la regione dell'account corretti.
Genera o inserisci il tuo Webhook Secret nel campo corrispondente.
Clicca su Salva o Connetti.
Una volta salvato, il tuo account Mercado Pago sarà collegato; ora abiliteremo i webhook nell'app Mercado Pago.
Passaggio 4: Configura i webhook in Mercado Pago
Alcune integrazioni Mercado Pago richiedono notifiche webhook affinché gli eventi di pagamento si sincronizzino correttamente con Squadd. Accedi al tuo account Mercado Pago e vai al pannello sviluppatori. (https://www.mercadopago.com.br/developers/en)
In Mercado Pago, apri l'applicazione utilizzata per l'integrazione e vai su Webhooks.
Clicca su Configura notifiche.
Completa la configurazione webhook richiesta affinché gli eventi di pagamento si sincronizzino correttamente con GoHighLevel / Squadd.
Incolla l'URL webhook nel campo URL modalità produzione: https://backend.LeadConnectorhq.com/payments/mercado-pago/webhook
Aggiungi lo stesso Webhook secret inserito nella pagina di Squadd / LeadConnector
Seleziona l'evento 'Pagamento' richiesto per la tua integrazione.
Salva le modifiche.
Passaggio 5: Assegna Mercado Pago per canale
Dopo aver connesso l'integrazione, apri Gestisci configurazioni provider per Mercado Pago in GoHighLevel / Squadd.
Attiva/disattiva la modalità Live o Test secondo necessità.
Assegna Mercado Pago ai canali in cui vuoi che sia disponibile.
Per ulteriori dettagli sull'assegnazione dei provider di pagamento per canale, consulta Configura i provider di pagamento per canale.
Domande frequenti
D: Esistono importi minimi nel mio paese?
Sì. Mercado Pago ha regole specifiche sugli importi minimi e massimi dei pagamenti a seconda del metodo di pagamento. Se crei un prodotto che non soddisfa queste condizioni, il pagamento potrebbe fallire. I riferimenti attuali si basano sui limiti di pagamento supportati da Mercado Pago:
Carte di credito e di 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 del servizio uguale alla valuta del tuo account Mercado Pago locale.
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 a causa delle sue condizioni di sicurezza. È possibile aprire un solo schermo 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 alla 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 abbonamenti, 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 utilizzata per firmare le richieste payload. Può essere una password che ricordi, ma deve corrispondere sia sul lato Squadd / LeadConnector che sul lato Mercado Pago. Puoi anche utilizzare un generatore di webhook secret online, che produrrà un secret basato sull'algoritmo hmac-sha256 come questo, risultato più sicuro - e70fd2ccfed7cf82596fe0494925a0ada87e3b03873a83150bd5458754650211 (solo a titolo di esempio)
D: Cos'è l'abilitazione dell'account CVV/CVC-less?
Il CVV o CVC è il codice di sicurezza a 3 o 4 cifre stampato su una carta di credito o di 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 avvia un abbonamento con una carta già salvata, chiedere al cliente di inserire il CVV ogni volta può creare attrito e aumentare i tassi di abbandono.
Per evitare questo, 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 Squadd / LeadConnector come abbonamenti, pagamenti off-session e flussi di fatturazione SaaS.
Il tuo account Mercado Pago potrebbe avere questa funzione già abilitata, ma dovrai verificarlo con il team di supporto di Mercado Pago. Se non è abilitata, dovrai richiederne l'attivazione.