Home page di PayPal Assistenza Cerca nella Centrale sviluppatori PayPal Cerca. Centrale sviluppatori Carrelli Come fare Libreria Forum

Transcript

1 Home page di PayPal Assistenza Cerca nella Centrale sviluppatori PayPal Cerca Cerca HTML Centrale sviluppatori Carrelli Come fare Libreria Forum Informazioni generali sull'integrazione HTML Informazioni generali Pagamenti su sito web Variabili IPN e PDT API Riepilogo Pagamento express Pagamenti su sito web Riferimento API Endpoint API Test Sandbox PayPal Introduzione Sandbox Registrati Accedi Forum Sandbox Centrale sviluppatori > Come fare > HTML > Pagamenti su sito web > Comando Carica carrello Aggiornato il 15 luglio 2009 Informazioni generali Pagamenti su sito web Informazioni generali Pulsanti Paga adesso Pulsanti Donazione

2 Pulsanti Donazione Pulsanti Iscriviti Pulsanti Aggiungi al carrello Comando Carica carrello Pulsanti Protezione pagamento standard Autorizzazione e riscossione Modulo HTML base Riferimento variabili standard Trasferimento dei dati del pagamento Variabili IPN e PDT Altre risorse Riferimento variabili standard Documentazione Notifica immediata del pagamento Community Serve uno sviluppatore? Directory sviluppatori certificati Carrelli di terze parti Il comando di caricamento carrello Il capitolo descrive come sviluppare un carrello di terze parti compatibile con PayPal e i Pagamenti su sito web. Nota: Se non sei uno sviluppatore di terze parti puoi facilmente aggiungere un Carrello PayPal ospitato da PayPal. Vedi Carrello PayPal Pulsanti Aggiungi al carrello e Visualizza carrello. I seguenti argomenti riportano ulteriori informazioni sui carrelli di terze parti: Funzioni del carrello di terze parti Integrazione di PayPal con un carrello di terze parti Funzioni del carrello di terze parti Questo esempio mostra le funzioni di un carrello di terze parti in PayPal e nei Pagamenti su sito web. Il commerciante nell'esempio ha le seguenti impostazioni nel Profilo del proprio conto:

3 proprio conto: Conto PayPal opzionale attivato. L'acquirente può pagare senza un conto PayPal esistente e può crearne uno dopo avere effettuato il pagamento. Per ulteriori informazioni, vedi Conto PayPal opzionale. I calcoli per le spedizioni sono impostati. PayPal calcola le spese di spedizione automaticamente e le aggiunge all'ordine. Per maggiori informazioni, vedi Calcolo automatico delle spese di spedizione (solo per commercianti statunitensi) oppure Calcolo automatico delle spese di spedizione (solo per commercianti non statunitensi). Il Ritorno automatico è disattivato. Gli acquirenti devono cliccare sul pulsante Torna al commerciante per reindirizzare i browser al sito del commerciante una volta completato il pagamento. Per maggiori informazioni, vedi Ritorno automatico. Che cosa vede l'acquirente con carrelli di terze parti Roberto sta acquistando foto. Seleziona diverse foto cliccando su Aggiungi al carrello. Figura 1. Carrello di terze parti Aggiungi al carrello Nell'esempio, il carrello di terze parti è programmato in modo da visualizzare il contenuto del carrello a ogni clic su Aggiungi al carrello. Inoltre, Roberto clicca su

4 contenuto del carrello a ogni clic su Aggiungi al carrello. Inoltre, Roberto clicca su Visualizza carrello ogni volta per rivedere gli oggetti già nel carrello e per iniziare i Pagamenti PayPal su sito web. Figura 2. Carrello di terze parti Visualizza carrello Dopo avere selezionato gli oggetti da acquistare e le quantità, Roberto clicca sul pulsante Procedi al pagamento. Il browser reindirizza Roberto al sito PayPal Gli acquirenti con conti PayPal possono immettere le proprie credenziali PayPal e cliccare su Accedi. Figura 3. Carrello di terze parti Pagina di accesso per il pagamento con PayPal

5 Roberto non ha un conto PayPal, quindi immette le informazioni per il pagamento e la fatturazione e clicca su Rivedi pagamento. Roberto viene reindirizzato a una pagina di revisione dei dettagli del pagamento. Figura 4. Carrello di terze parti Pagina di revisione per il pagamento con PayPal

6 DesignerFotos ha imposto il calcolo delle spese di spedizione nel profilo conto in modo che PayPal aggiunga le spese di spedizione all'ordine. Roberto clicca su Paga $505,00 adesso per completare il pagamento. Il browser viene reindirizzato alla pagina di conferma del pagamento. DesignerFotos ha Ritorno automatico disattivato nel profilo conto, quindi la pagina riporta un pulsante per ritornare al sito DesignerFotos. Roberto può: Cliccare su Ritorna a DesignerFotos. Cliccare su Visualizza ricevuta per la stampa. Cliccare su Crea conto per creare un conto PayPal. Roberto non dispone di un conto PayPal e sceglie di aprirne uno cliccando su Crea conto. Le informazioni sul pagamento e sulla spedizione usate per la transazione vengono aggiunte automaticamente al suo conto PayPal. Figura 5. Carrello di terze parti Pagina di conferma del pagamento PayPal

7 Figura 5. Carrello di terze parti Pagina di conferma del pagamento PayPal PayPal invia una notifica del pagamento a DesignerFotos. Figura 6. Ricevuta di pagamento da PayPal all'acquirente Che cosa vede il commerciante

8 Che cosa vede il commerciante PayPal invia a DesignerFotos una notifica del pagamento di Roberto. Figura 7. Ricevuta di pagamento da PayPal al commerciante Nota: DesignerFotos (seller@designerfotos.com) può anche vedere il pagamento nella cronologia del conto PayPal. Integrazione di PayPal con un carrello di terze parti Diversi commercianti utilizzano carrelli di terze parti già integrati con PayPal. Questa sezione descrive come gli sviluppatori di terze parti integrano i carrelli di terze parti in PayPal utilizzando Pagamenti su sito web. Variabili obbligatorie Il codice HTML richiede almeno le seguenti variabili nascoste. Un elenco completo di variabili è riportato in Variabili HTML per Pagamenti su sito web. Tabella 1. Variabili obbligatorie Nome amount_1 Descrizione Prezzo dell'oggetto o il prezzo totale di tutti gli oggetti aggiunti al carrello.

9 amount_1 Prezzo dell'oggetto o il prezzo totale di tutti gli oggetti aggiunti al carrello. business Indirizzo ema specificato per il conto PayPal. item_name_1 Nome dell'oggetto oppure nome del carrello. Carica Indica l'uso di un carrello di terze parti Esistono due modi per integrare il carrello di terze parti in PayPal e Pagamenti su sito web. Fornire i dettagli dei singoli oggetti. Fornire l'importo aggregato del pagamento. Fornire a PayPal i dettagli dei singoli oggetti Se il codice del carrello di terze parti indica di fornire i dettagli dei singoli oggetti, tali informazioni vengono incluse nelle cronologie e nelle notifiche per acquirente e commerciante. 1. Imposta la variabile cmd su _cart. 2. Includi la variabile upload: <input type="hidden" name="upload" value="1"> 3. Definisci i dettagli dell'oggetto per ciascun oggetto nel carrello. Specifica le variabili obbligatorie e quelle opzionali elencate in Valori consentiti per la variabile HTML cmd. Aggiungi _ x al nome della variabile, dove x è il numero dell'oggetto, che inizia con 1 e aumenta di uno per ciascun oggetto aggiunto al carrello. Il primo oggetto nel carrello deve essere definito con le variabili che terminano con _1, come ad esempio item_name_1, amount_1 e quantity_1; il secondo con variabili denominate, per esempio, item_name_2, amount_2 e quantity_2; il terzo con item_name_3, amount_3 e quantity_3 e così via. Importante: i valori _ x devono aumentare di uno in successione per essere riconosciuti. Se si passa

10 i valori _ x devono aumentare di uno in successione per essere riconosciuti. Se si passa dall'oggetto numero 1 all'oggetto numero 3 senza definire l'oggetto numero 2, il terzo oggetto verrà ignorato. Di seguito è riportato un esempio di codice HTML minimo. HTML per fornire i dettagli dei singoli oggetti a PayPal <form action=" bin/webscr" method="post"> <input type="hidden" name="cmd" value="_cart"> <input type="hidden" name="upload" value="1"> <input type="hidden" name="business" value="seller@designerfotos.com"> <input type="hidden" name="item_name_1" value="item Name 1"> <input type="hidden" name="amount_1" value="1.00"> <input type="hidden" name="item_name_2" value="item Name 2"> <input type="hidden" name="amount_2" value="2.00"> <input type="submit" value="paypal"> </form> Impostazione della valuta nel carrello Tutte le variabili monetarie, amount_ x, shipping_ x., shipping2_ x, handling_ x, tax_ xe tax_cart sono interpretate nella valuta della variabile currency_code relativa al pagamento. Poiché currency_code non è specifica per l'oggetto non è necessario aggiungere _ x al nome della variabile currency_code. Se non è presente una variabile currency_code, tutti i valori monetari sono definiti in Dollari US. Impostazione delle tasse sui singoli oggetti Utilizza tax_ x per specificare un'imposta per un oggetto. Ad esempio, la riga seguente indica l'imposta sull'oggetto 2 di 15 centesimi: <INPUT TYPE="hidden" name="tax_2" value=".15"> Impostazione delle spese di spedizione per singoli oggetti Utilizza weight_x e weight_unit per specificare il peso degli oggetti se il commerciante basa le spese di spedizione sul peso. Ad esempio, la riga seguente specifica il peso dell'oggetto 3 nel carrello come 1,5 kg. <INPUT TYPE="hidden" name="weight_3" value="1.5"> <INPUT TYPE="hidden" name="weight_unit" value="kgs"> Usa quantity_x se le spese di spedizione sono basate sulla quantità. Ad esempio, la riga seguente indica la quantità 6 per l'oggetto 3: <INPUT TYPE="hidden" name="quantity_3" value="6"> Impostazione della tassa per l'intero carrello

11 Impostazione della tassa per l'intero carrello Usa tax_cart per specificare l'imposta per l'intera transazione, non singolarmente per ciascun oggetto. La variabile tax_cart ha priorità sulle imposte individuali specificate con tax_ x Impostazione delle spese di spedizione per l'intero carrello Usa la variabile shipping per specificare l'importo totale delle spese di spedizione per l'intero carrello. Il valore di shipping è utilizzato per le spese di spedizione indipendentemente da quanto indicato nel profilo del commerciante. Impostazione del peso per l'intero carrello Usa weight_cart e weight_unit per specificare il peso totale del carrello, se nel proprio profilo il commerciante basa le spese di spedizione sul peso. La variabile weight_cart ha priorità sul peso dei singoli oggetti specificato con weight_x. Impostazione degli sconti per il carrello Usa le variabili di sconto per specificare le percentuali o gli importi di sconto. Usa discount_amount_cart per applicare un unico importo di sconto sull'intero carrello. Usa discount_amount_x per impostare un importo dello sconto associato con l'oggetto x Usa discount_ratet_cart per applicare un'unica percentuale di sconto sull'intero carrello. Usa discount_rate_x per impostare una percentuale di sconto associata con l'oggetto x L'importo dello sconto viene visualizzato su tutte le pagine, i messaggi e i report che mostrano le informazioni sul pagamento. Elaborazione della tassa predefinita e dello sconto Gli sconti specifici per gli oggetti vanno applicati prima delle imposte e sono calcolati nel carrello di terze parti. Gli sconti e le tasse sono applicati su ciascun oggetto in base alla percentuale di sconto e di tassazione specificata. Tuttavia, un acquirente vede solo un importo totale per il carrello e una voce per ogni tassa applicabile. Impostazione di sconti consolidati

12 Impostazione di sconti consolidati Gli sconti consolidati sono applicati all'intero carrello. Le imposte sono calcolate sul totale degli oggetti dopo l'applicazione dello sconto consolidato. L'acquirente vede un importo totale di sconto per il carrello e una voce per l'imposta sulle vendite applicabile. Quando usi gli sconti consolidati, specifica un valore di imposta consolidata in tax_cart. Se non specifichi un valore di imposta e il tuo profilo specifica una percentuale di tassazione, tale percentuale sarà applicata dopo lo sconto consolidato. Gli sconti consolidati sono ignorati se il carrello di terze parti contiene un oggetto con tassa individuale specificata con tax_x o tax_rate_x Passaggio a PayPal dell'importo cumulativo del carrello Puoi aggregare l'intero carrello e fornire a PayPal l'importo totale. Devi usare una sola variabile item_name_1 per l'intero carrello e amount_1 per il prezzo totale del contenuto del carrello, come se si trattasse dell'acquisto di un singolo oggetto. Nota: Tuttavia, in questo modo gli acquirenti non vedono i singoli oggetti nell'ordine nelle pagine di pagamento PayPal. Il seguente codice HTML è identico all'esempio #id08a3f8090pf/id08a3ge00jbi tranne che gli importi dei singoli oggetti e i nomi degli oggetti sono aggregati. HTML per dettagli aggregati del carrello a PayPal <form action=" bin/webscr" method="post"> <input type="hidden" name="cmd" value="_cart"> <input type="hidden" name="upload" value="1"> <input type="hidden" name="business" value="seller@designerfotos.com"> <input type="hidden" name="item_name_1" value="aggregated items"> <input type="hidden" name="amount_1" value="3.00"> <input type="submit" value="paypal"> </form> Protezione del carrello Una volta personalizzato il carrello di terze parti, puoi proteggerlo da manomissioni o usi non autorizzati utilizzando uno dei metodi descritti in Protezione dei pulsanti Pagamenti su sito web. Informazioni sulla nostra società Contattaci Tariffe Contratti legali