PAYPAL
Attivazione
Per rendere disponibile questo metodo di pagamento sulla pagina di cassa, è necessario configurare e attivare il servizio accedendo alla pagina dedicata a PayPal del back office XPay, all’interno del menu “Pagamenti Alternativi”. È necessario un account Paypal business.
Di seguito le indicazioni per attivare PayPal nel proprio e-commerce: guida attivazione PayPal.
Pagamento
Il pagamento con PayPal è compatibile e segue le specifiche delle seguenti soluzioni:
- Pagamento Semplice
- Pagamento ricorrente
- XPay Build: pagamento base e ricorrente
- I-Frame
Subisce però le seguenti variazioni in fase di avvio ed esito pagamento:
Messaggio di avvio pagamento: campi aggiuntivi per PayPal
| Obbligatorio | Nome | Descrizione | Formato |
|---|---|---|---|
| paypalCustom | Campo aggiuntivo che resta nel dettaglio ordine di PayPal. Corrisponde al campo PayPal "Numero personalizzato" (PAYMENTREQUEST_0_CUSTOM). | AN | |
| paypalInvoiceID | Identifica la fattura dell’esercente per PayPal, è un dato univico quindi l’esercente non può passare lo stesso valore per più di un ordine. Nel dettaglio ordine di PayPal corrisponde al campo "Nr ordine commerciante" (PAYMENTREQUEST_0_INVNUM). | AN | |
| shipping |
Se il metodo di pagamento gestisce questa funzione, vengono forniti in risposta i dati di spedizione.
Valori possibili: - "N": non vengono restituiti i dati di spedizione - "S": vengono restituiti i dati di spedizione Questo parametro sostituisce la configurazione del back office XPay, dove è possibile scegliere se ricevere i dati di spedizione per i metodi di pagamento senza l'utilizzo del parametro "shipping". |
AN |
Messaggio di esito e notifica pagamento: campi aggiuntivi per PayPal
| Obbligatorio | Nome | Descrizione | Formato |
|---|---|---|---|
|
|
PAYERID | Identificativo univoco account utente PayPal | AN MAX 13 |
|
|
PAYMENTINFO_0_TRANSACTIONID | Identificativo univoco transazione di pagamento | AN |
|
|
PAYMENTREQUEST_0_SHIPTONAME | Nome e cognome associati all'indirizzo di spedizione | AN MAX 128 |
|
|
PAYMENTREQUEST_0_SHIPTOSTREET | Primo campo indirizzo di spedizione | AN MAX 100 |
|
|
PAYMENTREQUEST_0_SHIPTOSTREET2 | Secondo campo facoltativo indirizzo di spedizione | AN MAX 100 |
|
|
PAYMENTREQUEST_0_SHIPTOCITY | Città dell'indirizzo di spedizione | AN MAX 40 |
|
|
PAYMENTREQUEST_0_SHIPTOSTATE | Sato o provincia di spedizione. Qui trovi la lista di PayPal per i codici degli stati | AN MAX 40 |
|
|
PAYMENTREQUEST_0_SHIPTOZIP | Codice Postale | AN MAX 20 |
|
|
PAYMENTREQUEST_0_SHIPTOCOUNTRYCODE | Codice Stato | AN MAX 2 |
|
|
PAYMENTREQUEST_0_SHIPTOCOUNTRYNAME | Stato | AN MAX 20 |
| BILLINGAGREEMENTACCEPTEDSTATUS | Indica se il cliente accetta o meno i pagamenti ricorrenti (valorizzato con "1" se accetta altrimenti con "0") | N | |
| BILLINGAGREEMENTID | Token che PayPal associa al numero contratto di Nexi | AN |
XPay gestisce la modalità Smart Payment Button messa a disposizione da Paypal.
Pagamento ricorrente
Per abilitare le ricorrenze nel proprio account PayPal è necessario contattare l’assistenza clienti PayPal così da attivare le "Reference Transaction".
Per conoscere se il servizio è attivo è necessario consultare il parametro in esito "BILLINGAGREEMENTACCEPTEDSTATUS" (1 abilitato, 0 non abilitato).