PayPal

Ingrandisci

Inizia con PayPal#

Questa pagina fornisce una guida completa per integrare con successo Paypal con DEUNA.

PayPal è una piattaforma di pagamento digitale riconosciuta a livello globale che fornisce un modo sicuro e conveniente per i clienti e i commercianti di fare e ricevere pagamenti elettronici.

Come funziona#

Ci sono due tipi di processi di pagamento in PayPal che puoi scegliere in base alle tue esigenze:

PayPal Checkout

Un'esperienza di pagamento di una volta che ti dà più controllo sull'intero processo di checkout.

• Offre un flusso di checkout semplificato che mantiene i clienti locali al tuo sito durante il processo di autorizzazione al pagamento.
• Il checkout non fornisce la possibilità di memorizzare un account PayPal del cliente.
• Il checkout avviene solo per utenti non autenticati o nuovi e quindi, poiché non hanno un'identità esistente, non hanno ancora la possibilità di selezionare le rate di pagamento.

Vault di PayPal

Questo flusso consente di addebitare l'account in futuro senza richiedere al cliente di essere presente durante la transazione o di ri-autenticicare con PayPal quando sono presenti durante la transazione.

• PayPal Vault è disponibile solo per gli utenti autenticati.
• Vault ha la possibilità di selezionare le rate di pagamento.

Requisiti#

I seguenti contenuti elencano tutti i requisiti per una corretta integrazione con PayPal.

• Ambienti:
  • Sandbox: https://api.sandbox.deuna.io
  • Produzione: https://api.deuna.io
• Collezione Postman:
  https://www.postman.com/deunaonline/workspace/deuna/folder/30572503-42f68d9b-0763-4002-ba5f-7d1168462e59?action=share&source=copy-link&creator=36841419&ctx=documentation

Procedura di integrazione#

Ora che i requisiti tecnici sono impostati, è possibile avviare l'integrazione.

1. Impostare il processore di pagamento

1. Aggiungi il portafoglio PayPal al tuo Connessione all'amministratore DEUNA.
2. Cerca "PayPal Wallet" e poi inserisci le credenziali del tuo account PayPal.

2. Pay Now Pulsante

• Questa opzione è controllata direttamente nella DEUNA Admin, sotto le impostazioni del metodo di pagamento PayPal del vostro commerciante.

• Predefinito: CONTINUE — abilitato per impostazione predefinita per tutti i commercianti (non è necessario agire).

• I commercianti possono abilitare "Pay Now" in qualsiasi momento direttamente dall'Admin, senza bisogno di una nuova integrazione tecnica.

• Il cambiamento può essere ritorto ogni volta che necessario — questa non è una decisione di una volta fatta durante l'integrazione, ma un toggle il commerciante controlla indipendentemente.

  Come scegliere l'opzione giusta

• La domanda chiave da porre è: Una volta che l'acquirente approva il pagamento su PayPal, l'importo finale è già bloccato, senza ulteriori riepilogo sul mio sito prima della carica?

• Se la risposta è sì → utilizzare PAY ORA.

• Se la risposta è no (l'acquirente può ancora cambiare gli elementi, indirizzo, spedizione, add-on, o vede una schermata di conferma finale) → utilizzare l'opzione predefinita (non è necessario prendere alcuna azione).

  Quando usare PAY NOW

• Consigliato per flussi transazionali, dove il prezzo è già bloccato entro il momento in cui l'acquirente viene reindirizzato a PayPal:

  • Acquisto diretto / "Acquista ora" su una pagina di prodotto, senza carrello o passo di revisione aggiuntivo.

  • Biglietti o prenotazioni con un prezzo finale fisso al momento della selezione — cioè, nessuna selezione dei posti, bagagli o aggiornamenti che avvengono dopo il ritorno da PayPal.

  • Abbonamenti e pagamenti ricorrenti con importo fisso e immutabile.

  • Express / checkout con un clic, dove ogni ulteriore passo aumenta l'abbandono.

  • Prodotti digitali (app, giochi, contenuti), dove l'acquirente si aspetta "pagato = consegnato" istantaneamente.

    Quando usare CONTINUE (default)

  • Consigliato quando c'è ancora una conferma o una revisione passo sul sito del commerciante dopo il ritorno da PayPal:

    • Carrello multi-item, dove l'acquirente può aggiungere prodotti, applicare un coupon, o rivedere la spedizione prima di confermare.
    • I flussi in cui la spedizione o le tasse sono calcolati solo dopo l'approvazione (ad esempio, dipende dall'indirizzo di consegna).
    • Prenotazioni con opzioni aggiuntive dopo l'approvazione, come la selezione dei posti o aggiornamenti, prima della cattura finale.

3. Creare 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:

Considerazioni:

• Informazioni su order.items:
  • total_amount.original_amount deve essere unit_price.amount * quantity.
  • total_amount.amount deve 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 al order.total_tax_amount e meno order.discount_amount deve corrispondere con il order.total_amount.
• order.sub_total è la somma degli articoli prezzo unit meno sconti, questa somma aggiunta al order.total_tax_amount deve corrispondere order.total_amount.

4. Scegli il tipo di integrazione

Dopo aver creato un ordine, scegli il tipo di integrazione che meglio si adatta alle tue esigenze:

5. Integrare FraudNet

Fraudnet è una libreria sviluppata da PayPal che analizza i dati inviati attraverso il browser durante l'intero processo di acquisto per prevenire possibili frodi nelle transazioni effettuate.

Fraudnet deve essere in esecuzione durante il processo di transazione. Per la sua integrazione, PayPal fornisce la seguente documentazione: Integrare FraudNet

6. Convalida dei pagamenti

Convalida i pagamenti e assicurati di usare correttamente le regole PayPal.

Importo sconto

Gli sconti in PayPal sono supportati a livello di ordine. Sul carico di pagamento, è necessario elaborare qualsiasi sconto attraverso il discount_amount field.