Suggerimenti per la risoluzione dei problemi relativi ai pulsanti e ai link di pagamento PayPal
Ricevo un errore e il pulsante non viene visualizzato sul mio sito.
- Verifica che la tua connessione Internet funzioni.
- Visita altre pagine del tuo sito web e controlla che vengano caricate correttamente.
- Vai alla pagina Pulsanti PayPal e controlla:
* Il pulsante viene visualizzato in "Pulsanti salvati"?
* Seleziona Modifica e assicurati che il codice del pulsante corrisponda a quello sul tuo sito web. - Con il pulsante destro del mouse clicca la pagina del prodotto (dove hai incollato il codice pulsante), quindi "Ispeziona". Vai alla scheda Console (la vedrai in alto). È possibile che vengano visualizzati errori relativi al PIN di assistenza personale. Se hai implementato i criteri di sicurezza dei contenuti, potresti visualizzare errori relativi al PIN di assistenza personale come questi di esempio:
- Ha rifiutato di caricare lo script "https://www.paypal.com/sdk/js**" perché viola la seguente direttiva sui criteri di sicurezza dei contenuti: "default-src 'self'". Nota che "script-src-elem" non è stato impostato in modo esplicito, quindi "default-src" è usato come fallback.
- Ha rifiutato di collegarsi a "https://www.paypal.com/**" perché viola la seguente direttiva sui criteri di sicurezza dei contenuti: "default-src 'self'". Nota che "connect-src" non è stato impostato in modo esplicito, quindi "default-src" è usato come fallback.
- Ha rifiutato di eseguire lo script inline perché viola la seguente direttiva sui criteri di sicurezza dei contenuti: "script-src https://*.paypal.com". Per abilitare l'esecuzione inline, è necessaria la parola chiave "unsafe-inline", un hash ("sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=") o un nonce ("nonce-...").
- Ha rifiutato di caricare l'immagine "https://tracking.qa.paypal.com/webapps/tracking/ts?**" perché viola la seguente direttiva sui criteri di sicurezza dei contenuti: "default-src 'self'". Nota che "img-src" non è stato impostato in modo esplicito, quindi "default-src" è usato come fallback.
- Ha rifiutato di inquadrare "https://www.paypal.com/" perché viola la seguente direttiva sui criteri di sicurezza dei contenuti: "default-src 'self'". Nota che "frame-src" non è stato impostato in modo esplicito, quindi "default-src" è usato come fallback.
Puoi provare ad aggiungere quanto segue per risolvere uno degli errori di cui sopra:
Opzione-1 (HTML): Se il PIN di assistenza personale è configurato in un file HTML, usa il codice seguente per sostituire il codice del PIN di assistenza personale
<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">
Opzione-2 (lato server): Se il PIN di assistenza personale è configurato lato server, usa il codice seguente per sostituire il codice del PIN di assistenza personale
Content-Security-Policy: script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com
Content-Security-Policy: style-src 'unsafe-inline' https://*.paypal.com
Content-Security-Policy: connect-src https://*.paypal.com
Content-Security-Policy: frame-src https://*.paypal.com
Content-Security-Policy: img-src https://*.paypal.com https://*.paypalobjects.com
Come faccio a modificare il layout, la dimensione o il colore del nome del prodotto, del prezzo o della quantità?
Ecco come modificare il layout, le dimensioni e il colore di nome, prezzo e quantità dei prodotti sul sito PayPal:
- Vai alla pagina dei pulsanti PayPal.
- Clicca Apri accanto al pulsante salvato e seleziona Modifica.
- Clicca Personalizza i pulsanti e apporta le modifiche necessarie.
Ho modificato le informazioni sul prodotto (nome, importo o altro); devo
copiare/incollare di nuovo il codice del pulsante?
No, prendiamo tutte le informazioni dal server PayPal. Una volta salvate le modifiche sul tuo conto, non è necessario aggiornare il codice pulsante copia/incolla del tuo sito.
Nota: se modifichi il codice valuta sul prodotto, dovrai aggiornare il pulsante di pagamento.
Vedo un codice cliente all'interno del codice. Che cosa significa?
Il codice cliente corrisponde al codice cliente del commerciante che fa parte del tuo conto. Non devi modificarlo. Usalo così com'è all'interno del codice del pulsante.
Ho aggiunto più pulsanti, ma nessuno viene visualizzato sulla mia pagina web.
Più pulsanti nella stessa pagina web non funzioneranno nei seguenti scenari:
- Se hai copiato/incollato lo stesso codice pulsante più volte nella stessa pagina web, verrà visualizzato solo il primo pulsante. Non puoi ripetere più volte lo stesso codice pulsante.
- Se hai copiato/incollato diversi codici pulsante ma con altre valute nella stessa pagina web, verrà visualizzato solo il primo pulsante. Non puoi aggiungere valute estere sui pulsanti della stessa pagina web.
- Se hai copiato/incollato diversi codici pulsante e riscontri una certa lentezza, assicurati che il tag dello script con il codice cliente venga aggiunto una sola volta. La riga dello script apparirà come segue:
<script src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo¤cy=USD"></script>
Ho un conto PayPal Premier e non vedo i link e i pulsanti di pagamento come
opzione.
Questa funzione è disponibile solo per i conti PayPal Business. Per usare questa funzione, modifica la categoria conto o crea un conto Business.
Come posso testare questa esperienza su PayPal Sandbox?
I pulsanti e i link di pagamento sono disponibili per il test su Sandbox.
L'espansione in linea di credito o debito non viene visualizzata completamente sul mio
sito.
Assicurati che la larghezza e l'altezza del contenitore principale siano impostate in modo da contenere l'espansione in linea. Per maggiori informazioni, consulta l'assistenza o la documentazione della piattaforma di hosting.
I pulsanti e i link di pagamento supportano la notifica immediata di pagamento (IPN)?
Sì. Segui questi passaggi per configurare e abilitare IPN.
Ecco come trovare l'impostazione IPN su PayPal:
- Vai alle Impostazioni del tuo conto.
- Seleziona Notifiche e Notifiche immediate di pagamento.
- Clicca Aggiorna link.
Ecco come abilitare le impostazioni IPN:
- Aggiungi l'URL del gestore IPN e seleziona Ricevi messaggi IPN (attivato).
- Clicca Salva.
Gestione IPN nel codice del server:
- ogni volta che le transazioni di pulsanti e link di pagamento vengono completate, PayPal IPN richiama l'URL di notifica configurato nel passaggio 2.
Accesso alla cronologia IPN:
- https://www.sandbox.paypal.com/merchantnotification/ipn/history
- https://www.paypal.com/merchantnotification/ipn/history
Riferimenti
Introduzione: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/
Assicurati di usare l'URL IPN corretto nel codice server
Esempi per altre lingue GitHub - paypal/ipn-code-samples
Quando il cliente arriva alla pagina di reindirizzamento, quali informazioni
sull'acquisto vengono inviate da PayPal? I pulsanti e i link di pagamento supportano il trasferimento dati di pagamento?
Quali variabili sono supportate?
Sì, supportiamo le variabili di trasferimento dati di pagamento come documentato qui. Riceverai il trasferimento dati di pagamento se attivi l'impostazione Ritorno automatico durante la configurazione del pulsante e del link di pagamento.
I pulsanti e i link di pagamento supportano un'impostazione locale se questa viene aggiunta manualmente dal
commerciante nel codice del pulsante o nel link di pagamento?
Come impostazione predefinita, i pulsanti e i link di pagamento usano le preferenze del browser dei clienti per mostrare il codice del pulsante e il link di pagamento.
I commercianti possono annullare questa impostazione solo per il codice del pulsante e il link di pagamento aggiungendo "locale.x=fr_FR" come parametro di query. L'elenco dei codici supportati per le impostazioni locali è disponibile qui. Qualsiasi testo immesso da un commerciante durante la configurazione non verrà tradotto.
Esempio: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=jp_JP
Esempio:
<script src="……¤cy=USD&locale.x=jp_JP"></script>
È possibile nascondere alcune delle etichette che provengono dal codice del pulsante e
dai link di pagamento?
Comprendiamo che potresti avere una configurazione visiva diversa sul tuo sito, tuttavia, non ti consigliamo di nascondere il codice del pulsante che forniamo.
Nascondere tali codici dal sito non cambierà il modo in cui viene elaborata la transazione. La transazione continuerà a usare la configurazione del codice del pulsante ospitato.
Puoi nascondere tutto o parte del testo attorno ai pulsanti quando usi un tipo di pulsante che non richiede l'input del cliente. Ad esempio, se il cliente deve selezionare la quantità o un elenco di selezione di più articoli e hai nascosto tali elementi di input, la transazione avrà esito negativo.
Ecco un esempio di come nascondere il prezzo di un articolo:
Aggiungi questo script sotto il codice del pulsante, sostituisci HostedButton_ID con il codice del pulsante effettivo.
<style> #paypal-container-<HostedButton_ID> {
#paypal-form-fields-container-<HostedButton_ID> {
#price-label {
display: none !important;
}
}
}
</style>
-
desc-label (per il nome del prodotto) -
price-label (per il prezzo)
style> #paypal-container-
<style>
#paypal-container-<HostedButton_ID>
{
#paypal-form-fields-container-<HostedButton_ID>
{
display: none !important;
}
}
</style>
È possibile eseguire l'override dei pulsanti e dei link di pagamento per applicare "Usa spedizione da
Impostazioni"?
I pulsanti e i link di pagamento non rispetteranno l'override in blocco di Spedizione da Profilo e impostazioni, come indicato nella seguente impostazione da Impostazioni di spedizione.
Ho modificato la valuta del mio pulsante, ma non la vedo aggiornata sul
sito.
Se modifichi la valuta di un pulsante dopo averlo già incollato sul nostro sito, dovrai copiare/incollare nuovamente il codice pulsante sul tuo sito.
Non riesco a selezionare "Usa spedizione da Impostazioni" e "Usa imposta da
Impostazioni" quando seleziono "Non raccogliere indirizzo di spedizione".
Le impostazioni di spedizione e imposte dipendono dal CAP e/o dal Paese di spedizione del cliente. Se selezioni "Non raccogliere indirizzo di spedizione", non riceverai l'indirizzo di spedizione del cliente, il che impedirà il calcolo della spedizione e delle imposte dalle Impostazioni. Ti consigliamo di usare le altre opzioni disponibili nei menu a discesa "Spese di spedizione" e "Aliquota fiscale".
I pulsanti e i link di pagamento supportano i webhook?
Sì. Ecco come abilitare i webhook:
- Accedi alla dashboard sviluppatori utilizzando le credenziali del tuo conto commerciante.
- Passa a Live.
- Clicca App e credenziali.
- Scorri verso il basso e seleziona Gestisci webhook.
- Ora puoi aggiungere un URL webhook per Live. Se vuoi aggiungere webhook per sandbox, rimani su questa pagina e passa da Live a Sandbox dall'angolo in alto a destra.
- Aggiungi l'URL di callback dei webhook, seleziona tutti gli eventi o pagamento, gli eventi di pagamento che verranno richiamati da PayPal in caso di eventi selezionati a seconda dell'implementazione dell'NVP o dell'API SOAP, effettua una chiamata all'API NVP/SOAP di PayPal per informazioni sui webhook.
Esempio di risposta webhook:
"id": "WH-12D11567VE3425924-2G120938U32719946",
"event_version": "1.0",
"create_time": "2024-09-14T15:55:58.043Z",
"resource_type": "capture",
"resource_version": "2.0",
"event_type": "PAYMENT.CAPTURE.COMPLETED",
"summary": "Payment completed for $ 128.88 USD",
"resource": {
"supplementary_data": {
"related_ids": {
"order_id": "8LM68409BR5528307"
}
],
"id": "7KK30254642170736",
"status": "COMPLETED"