PayPal tramite Widget
In questa pagina
Questa pagina include i passaggi necessari per integrare PayPal utilizzando il DEUNA Widget.
Procedura di integrazione#
Ora che i requisiti tecnici sono impostati, è possibile avviare l'integrazione.
1. Impostare il processore di pagamento
- Aggiungi il portafoglio PayPal al tuo Connessione all'amministratore DEUNA.
- Cerca "PayPal Wallet" e poi inserisci le credenziali del tuo account PayPal.
Connessioni
Scopri e gestisci le integrazioni di pagamento, wallet e antifrode.
| Connessioni | Tipo | Stato | Azione |
|---|---|---|---|
| Adyen | Gateway di pagamento | Connessa | |
| Worldpay | Gateway di pagamento | Connessa | |
| PayPal | Metodo di pagamento | Connessa | |
| Mercado Pago | Metodo di pagamento | Non connessa | |
| Riskified | Motore antifrode | Non connessa |
2. Crea ordine
Per effettuare un acquisto, è necessario prima creare un ordine DEUNA.
Seguire i passaggi per Creare un Ordine.
L'API restituirà un order_token che viene utilizzato durante tutto il flusso.
Campi obbligatori:
| Campo | Descrizione | Valore |
|---|---|---|
order.store_code | Codice unico di negozio | all |
order.payment_method | Tipo di metodo di pagamento DEUNA. (Per l'integrazione API) | wallet |
order.items_total_amount | Totale degli articoli senza tasse e sconti. | 2000 |
Considerazioni:
- Informazioni su
order.items:total_amount.original_amountdeve essereunit_price.amount * quantity.total_amount.amountdeve essere((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.total_amount.total_discountè il valore totale degli sconti per la quantità di articoli.
order.items_total_amountè la somma dei prezzi unitari degli articoli, questa somma aggiunta alorder.total_tax_amounte menoorder.discount_amountdeve corrispondere con ilorder.total_amount.order.sub_totalè la somma degli articoli prezzo unit meno sconti, questa somma aggiunta alorder.total_tax_amountdeve corrispondereorder.total_amount.
3. Crea utente (opzionale)
Creare un utente con DEUNA al fine di ottenere il token di autorizzazione per eseguire l'acquisto in seguito. Questa API restituirà un utente token che sarà necessario seguire i prossimi passi.
Per creare un utente, segui il API Riferimento. Nel caso in cui l'email utilizzata già esiste, l'API restituirà il messaggio user already exists, così si può procedere Richiedi l'OTP e poi, Accedi con l'OTP per ottenere un utente fresco token e procedere con l'acquisto.
Pagamenti Widget#
Il widget DEUNA consente due processi di pagamento per il Widget PayPal in DEUNA, che sono documentati in questa guida. Ogni processo viene avviato a seconda degli attributi dell'utente che effettua l'acquisto.
- Processo espresso: Completa il pagamento nel più breve tempo possibile.
- Processo generale: Consente diversi metodi di pagamento.
Express Express#
Il flusso espresso viene inizializzato quando il widget rileva un'esperienza di metodo di pagamento unico. Questo flusso consente all'utente di completare il pagamento nel più breve tempo possibile.
Una volta che l'utente dà il consenso per salvare il proprio account PayPal, il pagamento viene effettuato automaticamente e con un solo clic.
Nuovo o ospite con voltaggio disabilitato
Il flusso degli ospiti è definito per i nuovi utenti, utenti registrati che non sono autenticati o quando il commerciante ha disabilitato la funzione Vaulting. In questo caso, il processo di pagamento del checkout viene inizializzato, dove l'utente entrerà nel proprio account PayPal per effettuare il pagamento ma non verrà salvato.
Se l'utente è nuovo, i dati vengono registrati in modo che possano autenticarsi per un futuro acquisto e salvare il proprio account PayPal per i pagamenti futuri.
utente autenticato senza account PayPal salvato
Se l'utente è connesso ma non ha un account PayPal salvato, viene avviato il processo di pagamento a volta e l'utente viene reindirizzato al sito PayPal dove effettuerà il pagamento e darà il consenso per salvare il proprio account e utilizzarlo per gli acquisti futuri.
utente autenticato con account PayPal salvato
Se l'utente ha autenticato e già ha un account PayPal salvato, il pagamento viene immediatamente elaborato perché in precedenza hanno dato il proprio consenso.
Generale#
Il flusso generale è abilitato quando il widget rileva un'esperienza con più metodi di pagamento.
L'utente avrà un ruolo maggiore perché è in grado di gestire i propri account, cioè, sono in grado di aggiungere più account o cancellare uno che non utilizzano più.
Gli utenti autenticati hanno anche la possibilità di selezionare le rate di pagamento a seconda che il commerciante richieda o le permetta.
Nuovo o ospite con voltaggio disabilitato
Quando l'utente è un utente non autorizzato/nuovo o il commerciante ha disabilitato la funzione Vaulting:
- L'utente clicca sul pulsante PayPal
- Inizia il processo di pagamento del checkout
- L'utente deve autenticarsi in PayPal e effettuare il pagamento.
In questo processo, l'account non viene salvato perché non esiste una precedente identificazione dell'utente, e i loro dati saranno già registrati (se sono nuovi) in modo che in un futuro acquisto avranno la possibilità di autenticarsi e dare il consenso per salvare il loro account PayPal.
Esempio di acquisto
Ecco un esempio di un utente che effettua un acquisto con PayPal in DEUNA:
utente autenticato senza account PayPal salvato
Quando l'utente ha autenticato e non ha account salvati:
- Il processo di pagamento a volta viene avviato e l'utente viene reindirizzato a PayPal.
- L'utente effettua il pagamento sul sito di PayPal.
- L'utente dà il proprio consenso per salvare il proprio account e/o utilizzarlo per le transazioni future.
Se il commerciante richiede rate di pagamento, l'utente dovrà selezionarli dopo aver autorizzato il pagamento in PayPal.
utente autenticato con account PayPal salvati
Se l'utente è connesso e ha salvato account PayPal, allora possono selezionare qualsiasi account per effettuare il pagamento. L'utente può anche eliminare qualsiasi account o salvare un nuovo.
Se il commerciante offre rate di pagamento, questi vengono visualizzati con l'account selezionato per il pagamento e se l'utente vuole utilizzare un nuovo account PayPal, dovranno selezionare le rate dopo aver autorizzato il pagamento in PayPal.
Vista sul singolo conto
Questo è un esempio di un utente con un singolo account PayPal in DEUNA:
Visualizzazione di conti multipli
Questo è un esempio di un utente con più account PayPal in DEUNA:
Esempio di acquisto
Questo è un esempio di un utente che effettua un acquisto con PayPal in DEUNA:
Contrasmissione di transazioni PayPal con Vaulting
Quando un ordine PayPal viene respinto durante il flusso di Vaulting, rimuoveremo automaticamente il gettone PayPal associato all'account utilizzato nel tentativo fallito.
Ciò impedisce le transazioni future con l'account non valido. Subito dopo, il widget riavvia il processo PayPal in modo che l'utente possa ri-autenticicare e collegare un nuovo account PayPal valido per completare il pagamento.
Importo sconto
Gli sconti in PayPal sono supportati a livello di ordine. Sul carico di pagamento, è necessario elaborare qualsiasi sconto attraverso discount_amount.