Passa al contenuto principale

PayPal

Perché scegliere PayPal​

PayPal è uno dei metodi di pagamento più diffusi al mondo, disponibile in oltre 200 paesi. Integrarlo nell'ecommerce amplia le modalità di pagamento disponibili e aumenta la fiducia degli utenti grazie a un'esperienza di checkout consolidata e riconoscibile.

Approfondimento

Per ulteriori informazioni consulta il sito ufficiale

Servizi e funzionalità disponibili tramite integrazione Fabrick​

L'integrazione di PayPal con Fabrick Payment Orchestra mette a disposizione un ecosistema completo di funzionalità per semplificare la gestione delle transazioni e migliorare l'esperienza sia per il venditore che per il cliente.

  • Protezione venditore (Seller Protection): tutela l'esercente da transazioni non autorizzate o contestazioni, riducendo il rischio di frodi (scopri di più).
  • Fabrick Guaranteed Payments: servizio di prevenzione frodi a supporto dell'esercente (scopri di più).
  • Pagamento a rate: la soluzione Pay Later permette ai clienti di suddividere l'importo in rate, aumentando la flessibilità di acquisto (scopri di più).
  • Pagamenti ricorrenti: ideale per abbonamenti o servizi continuativi.
  • Gestione avanzata delle transazioni: supporto a catture e storni parziali o multipli per una gestione flessibile dei pagamenti.
  • Supporto multivaluta: compatibilità con diverse valute (lista completa).
  • Copertura internazionale: disponibile in oltre 200 paesi (scopri di più).
  • Riconciliazione semplificata: gestione dei pagamenti tramite report dedicati (scopri di più).
  • Chargeback: le contestazioni vengono gestite direttamente tramite la dashboard PayPal (scopri di più).

PayPal su Fabrick Payment Orchestra: attivazione e modalità di integrazione​

Richiesta di attivazione​

Puoi richiedere l'attivazione di PayPal tramite Fabrick:

  • Contattando il tuo referente commerciale
  • Contattando l'assistenza al seguente link

Collegamento dell'account PayPal Business​

Una volta attivato il metodo, è necessario collegare il tuo account PayPal Business alla piattaforma Fabrick:

Per completare il collegamento:

  1. Accedi alla Dashboard Fabrick

  2. Dal menu laterale, seleziona Workspace → Negozi → [Seleziona negozio] → Configurazioni → Attiva ora PayPal

  3. Clicca su Attiva ora, verrai reindirizzato alla pagina di collegamento PayPal PayPal

  4. Inserisci le credenziali del tuo account Business e conferma l'accesso

  5. Autorizza Fabrick cliccando su Consenti PayPal

  6. Dopo l'autorizzazione, clicca su Torna al negozio per completare la procedura PayPal

  7. Lo stato nella dashboard passerà da Attiva ora a Attivato PayPal

Attivazione completata

Da questo momento, il tuo e-commerce è pronto per accettare pagamenti PayPal tramite Fabrick Payment Orchestra.

Tipologie di integrazione​

Fabrick offre due modalità di integrazione per utilizzare PayPal:

  • Integrazione hosted

    Integrazioni supportate

    ✓HPPO
    ✓Pay By Link
    ✓Web Component
    ✓Lightbox

    PayPal viene mostrato direttamente nella pagina di pagamento Fabrick, senza alcun intervento di sviluppo lato merchant. Fabrick gestisce autonomamente la visualizzazione del metodo e l'intera fase di processamento.

  • Integrazione tramite API

    Integrazioni supportate

    ✓API Only

    In questa modalità il redirect verso PayPal viene gestito direttamente tramite API. È necessario inizializzare la transazione tramite payment/create e gestire il redirect del buyer.

Integrazione hosted​

PayPal viene mostrato direttamente nella pagina di pagamento Fabrick, senza alcuno sviluppo aggiuntivo da parte del merchant. Fabrick gestisce autonomamente la visualizzazione del metodo e l'intera fase di processamento della transazione.

PayPal

Quando l'utente seleziona PayPal, viene reindirizzato al servizio per effettuare il login e completare il pagamento.

PayPal

Integrazione tramite API​

Per richiedere il pagamento con PayPal utilizzando l'integrazione tramite API, è necessario inizializzare la transazione tramite payment/create utilizzando il tag PAYPAL nel campo paymentType e gestire il redirect del buyer verso il metodo di pagamento.

Creazione della transazione e redirect verso PayPal​

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json
{
  "shopLogin": "GESPAY12345",
  "amount": "100",
  "currency": "EUR",
  "shopTransactionID": "FBK_OrderID",
  "paymentType": ["PAYPAL"],
  "paymentChannel": { "channelType": ["LINK"] }
}

In risposta viene restituito nel campo payload.userRedirect.href il link per il redirect del buyer verso PayPal.

Response

{
  "error": {
    "code": "0",
    "description": "request correctly processed"
  },
  "payload": {
    "paymentToken": "f0419188-8a78-4918-913c-a491e4e78084",
    "paymentID": "1881129911957",
    "userRedirect": {
      "href": "https://sandbox-web.axerve.com/orchestra/checkout/a/f991s1ba01d24eacaa3fac4b2145262a/b/36ab092425ff34515f7430e38babb28b84f16a31d63102b829072a1366c13580ae128e86-d779-4d98-88a2-0c035bcbd42eiAQ8ZaRT3IFyanLLjcIxtsuc3DTwycBdj5FD7FjuhlKm-mNnpirMdm9p3O8bhycmHVVPz6QOyo811UzHG3csjOSlH2KbF2EiUIxEwWFPAvk9TdUDrgWtyKLJYWayfzbZlP4iULt9eHTvhJEhK21sS8Smd0hX"
    },
    "qrCode": null
  }
}
Pulsante PayPal

Il link restituito può essere utilizzato sotto un pulsante Paga con PayPal, rispettando le linee guida grafiche PayPal.

Funzionalità aggiuntive del metodo di pagamento​

Puoi abilitare funzionalità aggiuntive sulla transazione modificando la chiamata payment/create per includere i servizi specifici. I servizi configurati verranno applicati automaticamente alla transazione quando il cliente seleziona PayPal.

Seller Protection​

Per richiedere la funzionalità Seller Protection applicata ad una transazione PayPal, nella chiamata POST /payment/create, aggiungi l'oggetto OrderDetails valorizzando i campi di ShippingAddress, in questo modo le informazioni di spedizione verranno trasmesse correttamente a PayPal.

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json
{
  "shopLogin": "GESPAY12345",
  "amount": "10",
  "currency": "EUR",
  "shopTransactionID": "FBK_OrderID",
  "paymentType": ["PAYPAL"],
  "OrderDetails": {
    "ShippingAddress": {
      "FirstName": "John",
      "Lastname": "Doe",
      "StreetName": "Via Corradino Sella, 10",
      "Streetname2": "",
      "CountryCode": "IT",
      "State": "Biella",
      "StateCode": "BI",
      "City": "Biella",
      "ZipCode": "13900",
      "PrimaryPhone": "015012345"
    }
  }
}

PayPal

Fabrick Guaranteed Payment​

Per una transazione PayPal è possibile aggiungere il servizio Fabrick Guaranteed Payment in chiamata. Può essere utilizzato anche in combinazione con Seller Protection per un livello di tutela aggiuntivo.

Pagamento a rate​

Non è necessario aggiungere parametri specifici in chiamata, PayPal propone automaticamente la modalità a rate in base alle regole del servizio Pay Later. Al completamento della transazione l'intero importo viene accreditato all'esercente.

PayPal

Su richiesta è possibile abilitare il tasto Pay Later in modo separato.

PayPal

Redirect diretto verso il metodo di pagamento

Per effettuare il redirect del buyer verso il pagamento a rate, se hai richiesto l'attivazione separata del tasto Pay Later, nella chiamata POST /payment/create valorizza il campo paymentType con il tag PAYPAL_BNPL.

Pagamenti ricorrenti​

Inizializzazione del billing agreement​

Nella chiamata POST /payment/create aggiungi il campo payPalDescription con la descrizione dell'accordo. Non è necessario specificare paymentType: il sistema restituisce automaticamente un link diretto verso PayPal.

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json
{
  "shopLogin": "GESPAY12345",
  "amount": "100",
  "currency": "EUR",
  "shopTransactionID": "FBK_OrderID",
  "payPalDescription": "Description Billing Agreements"
}

Response

{
  "error": {
    "code": "0",
    "description": "request correctly processed"
  },
  "payload": {
    "paymentToken": "f0419188-8a78-4918-913c-a491e4e78084",
    "paymentID": "1881129911957",
    "userRedirect": {
      "href": "https://sandbox-web.axerve.com/orchestra/checkout/a/f991s1ba01d24eacaa3fac4b2145262a/b/36ab092425ff34515f7430e38babb28b84f16a31d63102b829072a1366c13580ae128e86-d779-4d98-88a2-0c035bcbd42eiAQ8ZaRT3IFyanLLjcIxtsuc3DTwycBdj5FD7FjuhlKm-mNnpirMdm9p3O8bhycmHVVPz6QOyo811UzHG3csjOSlH2KbF2EiUIxEwWFPAvk9TdUDrgWtyKLJYWayfzbZlP4iULt9eHTvhJEhK21sS8Smd0hX"
    },
    "qrCode": null
  }
}

Il buyer conferma l'autorizzazione cliccando Accetta e continua.

PayPal

Al completamento, recupera il token generato tramite GET /payment/detail nel campo payload.token e salvalo per i pagamenti successivi.

Request

GET api/v1/payment/detail/{paymentID}
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

Response

{
    "error": {
        "code": "0",
        "description": "request correctly processed"
    },
    "payload": {
        "transactionType": "detail",
        "transactionResult": "APPROVED",
        "transactionState": "AUT",
        "transactionErrorCode": "0",
        "transactionErrorDescription": "Transazione correttamente effettuata",
        "bankTransactionID": "1363",
        "shopTransactionID": "FBK_OrderID",
        "shopTransactionID_2": "",
        "authorizationCode": "PP7476",
        "paymentID": "1881129911957",
        "currency": "EUR",
        "country": "",
        "company": "PayPal",
        "tdLevel": "",
        "threeDS": {
            "authenticationResult": null,
            "transDetails": null
        },
        "events": [
            {
                "event": {
                    "eventtype": "AUT",
                    "eventamount": "10.00",
                    "eventdate": "07/05/25 14:45:31",
                    "eventARN": "",
                    "eventID": "",
                    "eventReferred": ""
                }
            }
        ],
        "buyer": {
            "name": "",
            "email": ""
        },
        "risk": {
            "riskResponseCode": "",
            "riskResponseDescription": ""
        },
        "customInfo": null,
        "alertCode": "",
        "alertDescription": "",
        "cvvPresent": "FALSE",
        "dcc": null,
        "maskedPAN": "",
        "paymentMethod": "PayPal",
        "productType": "",
        "token": "PPG5KMGN62NGKRLV",
        "tokenExpiryMonth": "",
        "tokenExpiryYear": "",
        "tokenDetails": null,
        "fraudPrevention": {
            "check": "FALSE",
            "state": "",
            "description": "",
            "order": ""
        },
        "automaticOperation": {
            "type": "CAN",
            "date": "01/06/25 00:00:00",
            "amount": "10.00"
        }
    }
}
Importo 0 €

È possibile impostare l'importo a 0 €. In questo modo, al momento dell'inizializzazione del billing agreement, PayPal non addebiterà alcun importo al cliente ma restituirà comunque il token necessario per i pagamenti successivi.

Dettaglio risposta

Request

GET api/v1/payment/detail/{paymentID}
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json

Response

{
  "error": {
    "code": "0",
    "description": "request correctly processed"
  },
  "payload": {
    "transactionType": "detail",
    "transactionResult": "APPROVED",
    "transactionState": "",
    "transactionErrorCode": "",
    "transactionErrorDescription": "",
    "bankTransactionID": "",
    "shopTransactionID": "",
    "shopTransactionID_2": "",
    "authorizationCode": "",
    "paymentID": "",
    "currency": "",
    "country": "",
    "company": "",
    "tdLevel": "",
    "threeDS": {
      "authenticationResult": null,
      "transDetails": null
    },
    "events": null,
    "buyer": null,
    "risk": null,
    "customInfo": null,
    "alertCode": "",
    "alertDescription": "",
    "cvvPresent": "",
    "dcc": null,
    "maskedPAN": "",
    "paymentMethod": "",
    "productType": "",
    "token": "PPG5KMGN62NGKRLV",
    "tokenExpiryMonth": "",
    "tokenExpiryYear": "",
    "tokenDetails": null,
    "fraudPrevention": null,
    "automaticOperation": null
  }
}
Cos'è il billing agreement?

Il billing agreement è un accordo tra il buyer e l'esercente che consente di addebitare il conto PayPal del cliente per pagamenti futuri, senza che il buyer debba autenticarsi nuovamente per ogni transazione. È la base per i pagamenti ricorrenti e on-demand tramite PayPal (scopri di più).

Compatibilità

Servizio non compatibile con il pagamento a rate.

Utilizzo del token per pagamenti successivi​

Crea la richiesta di pagamento utilizzando la chiamata POST /payment/create

Request

POST /api/v1/payment/create
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
Authorization: apikey ****************
Content-Type: application/json
{
  "shopLogin": "GESPAY12345",
  "amount": "100",
  "currency": "EUR",
  "shopTransactionID": "FBK_OrderID"
}

Response

{
  "error": {
    "code": "0",
    "description": "request correctly processed"
  },
  "payload": {
    "paymentToken": "f0419188-8a78-4918-913c-a491e4e78084",
    "paymentID": "1881129911957",
    "userRedirect": null,
    "qrCode": null
  }
}

Nella chiamata POST /payment/submit utilizza il token per processare il pagamento:

  • Header PaymentToken: valorizzare con il paymentToken ricevuto dallo step precente
  • Body: aggiungi paymentTypeDetails.payPal.token valorizzato con il token PayPal

Request

POST /api/v1/payment/submit
Host (sandbox): sandbox.gestpay.net
Host (produzione): ecomms2s.sella.it
PaymentToken: f0419188-8a78-4918-913c-a491e4e78084
Content-Type: application/json
{
  "shopLogin": "GESPAY12345",
  "paymentType": "PAYPAL",
  "paymentTypeDetails": {
    "payPal": {
      "token": "PPG5KMGN62NGKRLV"
    }
  }
}

Response

{
    "error": {
        "code": "0",
        "description": "request correctly processed"
    },
    "payload": {
        "transactionType": "submit",
        "transactionResult": "OK",
        "transactionErrorCode": "0",
        "transactionErrorDescription": "Transazione correttamente effettuata",
        "bankTransactionID": "1414",
        "shopTransactionID": "FBK_OrderID",
        "shopTransactionID_2": "",
        "authorizationCode": "PP2163",
        "paymentID": "1881129911957",
        "currency": "EUR",
        "country": "",
        "company": null,
        "tdLevel": "",
        "buyer": {
            "name": "",
            "email": ""
        },
        "risk": {
            "riskResponseCode": "",
            "riskResponseDescription": ""
        },
        "customInfo": {},
        "alertCode": "",
        "alertDescription": "",
        "cvvPresent": "",
        "maskedPAN": "",
        "paymentMethod": "",
        "productType": "",
        "token": "",
        "tokenExpiryMonth": "",
        "tokenExpiryYear": "",
        "userRedirect": {
            "href": "https://sandbox.gestpay.net/pagam/AxerveThankYou.aspx"
        }
    }
}
pagamento ricorrente

Se viene richiesto un pagamento ricorrente, il sistema restituisce un link diretto verso PayPal, saltando la pagina di selezione.

Riconciliazione​

Dalla sezione Report della dashboard puoi configurare report dedicati per le riconciliazioni.

Per eventi:

  • Numero personalizzato (PayPal) ↔ Chiave di riconciliazione (Fabrick)
  • Codice transazione (PayPal) ↔ ID PayPal (Fabrick)
  • N° ordine commerciante (PayPal) ↔ Shop transaction ID + _ + ID cattura (Fabrick)

Per pagamenti:

  • Numero personalizzato (PayPal) ↔ Chiave di riconciliazione (Fabrick)
  • Codice transazione (PayPal) ↔ ID PayPal (Fabrick)

Per approfondire consulta la guida alla dashboard.

Assistenza​

Fabrick

PayPal