Guida
Accedi

Utilizzo di Adyen su Shopify

Adyen è un canale di pagamento che consente alle aziende Enterprise di accettare pagamenti. I merchant con un account Adyen esistente possono utilizzare Adyen come gestore dei pagamenti direttamente all'interno di Shopify.

Puoi integrare Shopify, compresi i dati sui pagamenti di Adyen, con il software di Enterprise Resource Planning (ERP) per garantire una gestione dei dati e una sincronizzazione più fluide tra i sistemi.

In questa pagina

Requisiti di idoneità per Adyen su Shopify

Prima di poter utilizzare Adyen su Shopify, devi soddisfare i seguenti requisiti:

  • Devi avere un piano Enterprise.
  • La tua azienda deve soddisfare determinati criteri di idoneità in base all’area geografica.
  • Devi aver configurato un account Adyen prima di attivare l’integrazione.
  • Il negozio deve utilizzare Shopify Checkout.

L’accesso ad Adyen avviene solo su approvazione e non può essere garantito. Per richiedere l’attivazione di Adyen, contatta il tuo rappresentante commerciale o Merchant Success Manager (CSM) Shopify. Se non hai un Merchant Success Manager, puoi contattare l’Assistenza Shopify per ricevere indicazioni sui passaggi successivi.

Funzionalità incompatibili o non disponibili per Adyen su Shopify

Alcune funzionalità non sono disponibili o sono incompatibili con l’integrazione di Adyen su Shopify:

  • Klarna e PayPal non sono disponibili: Klarna e PayPal non sono supportati come metodi di pagamento tramite l’integrazione di Adyen su Shopify.
  • Non tutti i metodi di pagamento locali sono disponibili: i metodi di pagamento locali offerti tramite l’integrazione di Adyen su Shopify variano in base all’area geografica e potrebbero non includere tutti i metodi offerti direttamente da Adyen. Consulta la documentazione sui metodi di pagamento di Adyen per l’elenco completo.
  • Gli strumenti antifrode di Shopify non sono disponibili: quando utilizzi Adyen, non hai accesso agli strumenti antifrode di Shopify Payments, come la gestione delle contestazioni, la protezione dai test delle carte e le analisi delle frodi. Adyen offre i propri strumenti di prevenzione frodi, che potrebbero essere disponibili a un costo aggiuntivo. Puoi comunque utilizzare l’analisi del rischio di frode di Shopify e Shopify Flow per impostare regole personalizzate.
  • Managed Markets non è supportato: Managed Markets (servizio di venditore ufficiale) richiede Shopify Payments e non può essere utilizzato con Adyen.
  • I metodi di pagamento manuale non supportano la funzionalità multivaluta: la funzionalità multivaluta è attiva solo per le carte di credito. I metodi di pagamento manuale come il bonifico bancario o il contrassegno utilizzano per impostazione predefinita la valuta del negozio.

Attiva Adyen su Shopify

Prima di poter attivare Adyen, collabora con il tuo rappresentante commerciale o Merchant Success Manager Shopify per ricevere l’approvazione. Dopo aver ricevuto l’approvazione, configura un account con Adyen, quindi installa e attiva l’app di pagamento.

Passaggi:

  1. Dal pannello di controllo Shopify, vai su Impostazioni > Pagamenti.

  2. Nella sezione Shopify Payments, clicca su Gestisci.

  3. Clicca su Passa a un gestore di terze parti, quindi clicca di nuovo su Passa a un gestore di terze parti per confermare.

  4. Scegli Adyen Payments - Credit Cards dall’elenco dei gestori dei pagamenti disponibili. Se non possiedi l’approvazione per utilizzare Adyen, l’opzione Adyen Payments - Credit Cards non viene visualizzata nell’elenco dei gestori dei pagamenti.

  5. Clicca su Gestisci account.

  6. Se necessario, consenti all'estensione di pagamento Adyen di accedere ai dati del tuo negozio e di modificarli.

  7. Dalla pagina Adyen Payment Configuration, seleziona l’account Adyen che desideri utilizzare con il tuo negozio Shopify.

  8. Segui le istruzioni nell’Area clienti di Adyen per installare l’app di pagamento Adyen per Shopify e testare l’integrazione.

Configura le impostazioni di Adyen

Dopo aver attivato Adyen, puoi configurare le impostazioni in base alle esigenze della tua azienda.

Configura le impostazioni di acquisizione del pagamento

L’acquisizione del pagamento determina il momento in cui i fondi vengono prelevati dai clienti.

Passaggi:

  1. Dal pannello di controllo Shopify, vai su Impostazioni > Pagamenti.

  2. Nella sezione del gestore dei pagamenti, clicca su Gestisci.

  3. Scegli il tuo metodo di acquisizione preferito:

    • Acquisizione automatica: i pagamenti vengono acquisiti immediatamente al momento dell’ordine.
    • Acquisizione manuale: i pagamenti vengono autorizzati ma non acquisiti finché non li acquisisci manualmente.
    • Acquisizione all’evasione: i pagamenti vengono acquisiti quando evadi l’ordine.

Installa i metodi di pagamento locali

Per offrire metodi di pagamento locali tramite Adyen, devi prima avere installato l’app Adyen Payments - Credit Cards come canale di pagamento primario. Se non hai installato l’app per le carte di credito, non puoi installare i metodi di pagamento locali.

Dopo aver installato l’app per le carte di credito, contatta il tuo Merchant Success Manager o rappresentante commerciale Shopify per ottenere l’accesso ai metodi di pagamento locali per la tua area geografica.

Configura il pagamento a rate con carta di credito per Brasile e Messico

Se vendi a clienti in Brasile o Messico, puoi offrire il pagamento a rate con carta di credito al check-out.

Prima di configurare il pagamento a rate, verifica che siano soddisfatti i seguenti requisiti:

  • Per il Brasile, il tuo mercato deve utilizzare la valuta BRL (Real brasiliano).
  • Per il Messico, il tuo mercato deve utilizzare la valuta MXN (Peso messicano).
  • L’app Adyen Payments - Credit Cards deve essere installata come canale di pagamento primario.

Passaggi:

  1. Dal pannello di controllo Shopify, vai su Impostazioni > Pagamenti.

  2. Nella sezione Adyen Payments - Credit Cards, clicca su Gestisci.

  3. Clicca su Altre azioni, quindi clicca su Gestisci.

  4. Nella barra degli indirizzi del browser, aggiungi ?credit_card_installments=1 alla fine dell'URL, quindi premi Invio sulla tastiera.

  5. Le opzioni di configurazione delle rate vengono visualizzate in fondo alla pagina.

  6. Configura il numero massimo di rate e il pagamento minimo per rata. Le rate in Brasile possono essere configurate da 2 a 12 rate. Le rate in Messico possono essere configurate in 3, 6, 9, 12 o 18 rate.

  7. Clicca su Salva.

Usa Adyen con Shopify Markets

Adyen è compatibile con Shopify Markets. Quando Shopify Markets è attivato, le transazioni vengono elaborate nella valuta che Shopify invia ad Adyen.

Per vendere in più valute con Adyen, verifica che siano soddisfatti i seguenti requisiti:

  • Le valute dei mercati devono essere configurate anche nell'account Adyen.
  • Se la valuta è una delle valute di accredito di Adyen per la tua area geografica, Adyen accredita i fondi in quella stessa valuta.

Convalida l'integrazione con ordini di prova

Prima di iniziare ad accettare pagamenti reali, testa l'integrazione con Adyen usando le bozze di ordini per confermare che i pagamenti vengano elaborati correttamente.

Passaggi:

  1. Dal pannello di controllo Shopify, vai a Ordini > Bozze.

  2. Clicca su Crea ordine.

  3. Aggiungi un prodotto e le informazioni sul cliente.

  4. Clicca su Riscuoti pagamento e seleziona il metodo di pagamento preferito.

  5. Completa la procedura di pagamento e verifica che l'ordine sia visualizzato correttamente sia in Shopify sia nel portale Adyen.

Riconcilia gli ordini quando usi Adyen

Quando un ordine viene pagato tramite Adyen, Shopify invia un numero merchantReference ad Adyen per la transazione. Il numero merchantReference è un identificatore univoco che puoi usare per riconciliare gli ordini.

Il numero merchantReference è composto da due parti:

  • ID del negozio Shopify: la prima parte del numero identifica il negozio Shopify.
  • ID di pagamento: la seconda parte è l'ID di pagamento della transazione specifica.

Ad esempio, il numero merchantReference potrebbe essere visualizzato come 12345-67890. In questo esempio, 12345 è l'ID del negozio Shopify e 67890 è l'ID di pagamento.

L'ID di pagamento di una transazione viene visualizzato nella sequenza temporale dell'ordine del pannello di controllo Shopify.

Per riconciliare le transazioni, effettua una ricerca nel pannello di controllo Shopify utilizzando la parte del numero merchantReference corrispondente all'ID di pagamento. La funzione di ricerca restituisce l'ordine associato all'ID di pagamento.

Considerazioni per la riconciliazione degli ordini

Quando usi la sequenza temporale dell'ordine e l'ID di pagamento per riconciliare gli ordini con le transazioni in Adyen, tieni conto delle seguenti considerazioni:

  • Trovare la chiave di autorizzazione di un ordine: quando una transazione viene completata tramite Adyen, la chiave di autorizzazione non viene aggiornata nella sequenza temporale dell'ordine nel pannello di controllo Shopify. Per recuperare la chiave di autorizzazione di un ordine, fai riferimento all'account Adyen.
  • Stato del pagamento in attesa: i pagamenti potrebbero richiedere diversi giorni per l'elaborazione. Se non si riceve una risposta dal gestore dei pagamenti, i pagamenti potrebbero essere visualizzati come In attesa. Quando lo stato del pagamento cambia in Pagato, puoi evadere l'ordine.
  • Stato del pagamento scaduto: se lo stato del pagamento diventa Scaduto, prima di richiedere nuovamente il pagamento al cliente verifica che il pagamento non sia stato ricevuto nell'account Adyen. Lo stato del pagamento diventa Scaduto per indicare che non è stato possibile elaborarlo.

Risoluzione dei problemi comuni di Adyen

Se riscontri problemi con l'integrazione di Adyen, verifica i seguenti problemi comuni e le relative soluzioni.

Si tratta di un comportamento previsto per i metodi di pagamento locali (LPM) come AliPay e WeChat Pay. Il pagamento entra in uno stato di attesa finché non va a buon fine da parte dell'elaboratore. Una volta confermato il pagamento, lo stato viene aggiornato sia in Adyen sia in Shopify.

Cosa fare: attendi l'elaborazione del pagamento. La maggior parte dei pagamenti si aggiorna entro pochi minuti, ma alcuni possono richiedere fino a 10-15 minuti.

Questo può accadere se un cliente avvia un pagamento che richiede la verifica 3D Secure, ma abbandona la procedura o riscontra problemi indipendenti da Shopify.

Cosa fare:

  1. Controlla il portale Adyen per confermare che il pagamento sia stato acquisito.
  2. Se il pagamento è stato acquisito, crea una bozza di ordine in Shopify.
  3. Contrassegna la bozza di ordine come pagata ed evadila di conseguenza.
  4. Se il pagamento non è stato acquisito, non è necessaria alcuna azione.

Ciò può verificarsi quando un cliente completa la verifica 3D Secure ma non viene reindirizzato correttamente a Shopify. Il cliente potrebbe trovare due tentativi di autorizzazione nell'estratto conto.

Cosa fare:

  1. Controlla il portale Adyen per determinare quanti pagamenti sono stati effettivamente acquisiti.
  2. Se è stato acquisito un solo pagamento, avvisa il cliente che il secondo addebito è un'autorizzazione in sospeso che verrà rilasciata automaticamente dalla sua banca.
  3. Se sono stati acquisiti due pagamenti, rimborsa la transazione duplicata nel portale Adyen.

Se Adyen impiega più tempo del previsto per elaborare il rifiuto di un pagamento, quest'ultimo potrebbe passare allo stato in attesa e l'ordine verrà creato in Shopify.

Cosa fare:

  1. Controlla lo stato del pagamento sia nel pannello di controllo Shopify sia nel portale Adyen.
  2. Se il pagamento non è andato a buon fine, puoi annullare l’ordine o richiedere di nuovo il pagamento al cliente.

Ciò può verificarsi quando la sessione di un metodo di pagamento locale scade, ma il cliente risulta ancora autorizzato in Adyen.

Cosa fare:

  1. Attendi 10-15 minuti per consentire la sincronizzazione dello stato del pagamento tra Adyen e Shopify.
  2. Se il pagamento risulta completato in Adyen ma dopo 15 minuti l’ordine non è ancora stato creato in Shopify, crea una bozza di ordine e contrassegnala manualmente come pagata.

Questo errore in genere indica che il tuo negozio non soddisfa i requisiti di idoneità per utilizzare Adyen.

Cosa fare:

  1. Verifica che il negozio abbia un piano Enterprise.
  2. Contatta il tuo Customer Success Manager (CSM) o il rappresentante commerciale Shopify per discutere dell’idoneità e dell’attivazione.
  3. Se non hai un Customer Success Manager, contatta l’Assistenza Shopify per indicazioni sui passaggi successivi.

Se i metodi di pagamento locali non vengono visualizzati per i clienti, verifica che siano soddisfatti i seguenti requisiti:

  • L’app Adyen Payments - Credit Cards deve essere installata come canale di pagamento principale. Non puoi usare i metodi di pagamento locali senza di essa.
  • L’indirizzo di spedizione del cliente deve trovarsi in un'area geografica in cui è disponibile il metodo di pagamento locale.
  • La valuta del check-out deve essere supportata dal metodo di pagamento locale.

Cosa fare:

  1. Conferma che l’app Adyen Payments - Credit Cards sia installata e attiva.
  2. Verifica che i metodi di pagamento locali siano configurati correttamente nel tuo account Adyen.
  3. Testa il check-out con un indirizzo del cliente nell’area geografica di destinazione.

Se le rate della carta di credito non vengono visualizzate per i clienti in Brasile o in Messico, verifica che siano soddisfatti i seguenti requisiti:

  • Per il Brasile, il mercato deve utilizzare la valuta BRL (Real brasiliano).
  • Per il Messico, il mercato deve utilizzare la valuta MXN (Peso messicano).
  • L’app Adyen Payments - Credit Cards deve essere installata come canale di pagamento principale.
  • Le rate devono essere attivate utilizzando il parametro URL.
  • Non vengono utilizzate app di pagamento con credito in negozio e buoni regalo di terze parti (non sono compatibili con le rate).

Domande frequenti

No. Per elaborare i metodi di pagamento locali con Adyen, devi avere l’app Adyen Payments - Credit Cards installata come canale di pagamento principale. Adyen richiede questa configurazione e ne monitora l'utilizzo per impedire un'integrazione parziale.

No. Payment Service Provider (PSP) Reference di Adyen non viene memorizzato in Shopify. Tuttavia, il riferimento della transazione Shopify viene memorizzato all’interno del campo merchantReference nel portale di Adyen, che puoi usare per la riconciliazione.

Sì, l'app di pagamento Adyen supporta gli abbonamenti tramite le app in abbonamento integrate con Shopify Checkout. Se devi migrare gli abbonamenti esistenti su Adyen, contatta il tuo Customer Success Manager (CSM) o il rappresentante commerciale Shopify per discutere delle opzioni di migrazione.

Sì, Apple Pay (per iOS) e Google Pay (per Android) sono disponibili tramite l’integrazione con Adyen.

Sì, l’app Adyen supporta le offerte di upselling post-acquisto tramite l'estensione per il check-out post-acquisto. Fai riferimento alla documentazione per gli sviluppatori Shopify per le limitazioni e le considerazioni sulle estensioni per il check-out post-acquisto.

Il canale di pagamento legacy di Adyen non è più supportato e potrebbe causare problemi di pagamento. Se usi ancora il canale di pagamento legacy di Adyen, devi migrare immediatamente alla nuova Adyen Payment App.

Per migrare, contatta l'Assistenza Shopify o il tuo Customer Success Manager per ricevere indicazioni sul processo di migrazione.

Prima di contattare l'Assistenza Shopify in merito ad Adyen

Prima di contattare l'Assistenza Shopify per un problema relativo ad Adyen, raccogli le seguenti informazioni per aiutarci a risolverlo più rapidamente:

  • Il numero o i numeri di ordine interessati dal problema
  • La data e l'ora in cui si è verificato il problema
  • Le schermate di eventuali messaggi di errore ricevuti
  • Lo stato del pagamento visualizzato sia nel pannello di controllo Shopify che nel tuo portale Adyen
  • Il numero merchantReference da Adyen (se applicabile)
  • Una descrizione di ciò che ti aspettavi succedesse rispetto a ciò che è effettivamente successo
  • I passaggi della sezione sulla risoluzione dei problemi che hai già provato

Assistenza e risorse Adyen

Sapere quale team di assistenza contattare può migliorare la tua esperienza e aiutarti a ottenere risposte in modo più rapido quando utilizzi Adyen su Shopify.

Responsabilità dell'Assistenza Shopify

Per ricevere aiuto sull’integrazione di Adyen su Shopify, inclusa assistenza per la configurazione e la risoluzione dei problemi comuni, l'Assistenza Shopify è il tuo primo punto di contatto. L'Assistenza Shopify può fornire aiuto con i seguenti tipi di problemi:

  • Richiesta di accesso e attivazione del canale di pagamento Adyen su Shopify
  • Problemi tecnici relativi al canale di pagamento Adyen su Shopify
  • Risoluzione dei problemi di integrazione
  • Indicazioni sulla configurazione e sulla gestione delle impostazioni di Adyen all’interno di Shopify

Responsabilità dell'Assistenza Adyen

Per problemi specifici del tuo account Adyen, contatta direttamente l’assistenza Adyen all’indirizzo support@adyen.com. L'assistenza Adyen gestisce i seguenti tipi di richieste:

  • Verifica dell'account e onboarding del merchant
  • Conformità alle normative
  • Prezzi e tariffe di elaborazione
  • Programmazione degli accrediti, accrediti non andati a buon fine e altre domande relative agli accrediti
  • Strategie e strumenti di prevenzione frodi
  • Gestione di chargeback e contestazioni
  • Reportistica dettagliata ed esigenze di riconciliazione

Risorse

Per maggiori informazioni su Adyen e sulla relativa integrazione con Shopify, fai riferimento alle risorse seguenti: