laptop

Integrazione di Saferpay in 5 parole

Tutto sull'integrazione di Saferpay

Competente, affidabile, senza intoppi

Fase 1: Consulenza

Prima dell’installazione di Saferpay è importante comprendere le opzioni contrattuali e tecniche e i requisiti al fine di garantire un’integrazione ottimale già dall’inizio.

I nostri responsabili commerciali e tecnici sono a vostra disposizione per rispondere alle vostre domande contrattuali e tecniche.

Contattate il nostro team di integrazione per farvi consigliare sulle diverse opzioni di integrazione che meglio si adattano alle vostre necessità.

Prima di contattare il team di integrazione, date un’occhiata alla nostra documentazione API per una conoscenza generale di Saferpay JSON API.

Qualora fosse possibile, vi preghiamo di fornire al team di integrazione una descrizione dettagliata dei vostri progetti, delle vostre esigenze e dei vostri casi d’uso.

Fase 2: Periodo di prova

Saferpay offre la possibilità di testare in anticipo tutte le interfacce nell’ambiente di test Saferpay (Sandbox). Potete creare un account di prova che vi permetta di implementare Saferpay nel vostro sistema e di eseguire transazioni di prova con diversi simulatori di pagamento prima della messa in servizio.

Utilizzate l’ambiente di test Saferpay per testare completamente la vostra integrazione prima della messa in servizio.

Riceverete tramite e-mail tutti i dati di test dopo aver effettuato la registrazione.

Dopo aver ricevuto i dati di test per il vostro account tramite e-mail, potrete proseguire in due modi differenti a seconda del fatto che stiate usando un plugin oppure utilizzate un’integrazione personalizzata individuale.

  • Se per l'integrazione si utilizza un sistema di negozio standard (ad esempio Magento, PrestaShop, WooCommerce, ...), Worldline vi offre il plugin giusto.

    Maggiori informazioni >>

    Dopo aver installato con successo il plugin, è sufficiente inserire le credenziali di prova fornite nella vostra configurazione di plugin Saferpay:

    Dati richiesti

    • ID del cliente di prova
    • ID del terminale di prova (terminale e-commerce)
    • Nome utente JSON API di prova
    • Password JSON API di prova

    ! Assicuratevi che la modalità operativa del plugin sia passata alla “Modalità test”

    ! Dati di test: Potete utilizzare i seguenti dati di test/credenziali della carta per simulare transazioni di prova: Dati di test Saferpay

    Test plugin (esempio: WooCommerce)

    Nota: lo screenshot in alto mostra le impostazioni del plugin WooCommerce. Gli altri plugin per il negozio hanno una grafica diversa, ma richiedono gli stessi dati.

     

  • Potete utilizzare Saferpay JSON API (acronimo di: JavaScript Object Notation Application Programming Interface) per integrare Saferpay nei vostri sistemi di negozio, nelle vostre soluzioni per call-center, nei sistemi di gestione merci, ERP, PMS e CRM e in altre applicazioni in cui vengono effettuate transazioni di pagamento online.

    La documentazione e le specifiche JSON API descrivono dettagliatamente come integrare il vostro sistema con JSON API.

    Documentazione JSON API:

    Fornisce spiegazioni dettagliate su come integrare l’interfaccia della pagina di pagamento e l’interfaccia di transazione, le funzionalità opzionali, le prassi migliori, le FAQ e molto altro.

    Temi:

    • Requisiti di integrazione
    • Sicurezza dei dati e regolamenti PCI
    • Lista dei metodi di pagamento e delle funzionalità supportate
    • Lista delle funzionalità delle due interfacce (pagina di pagamento e interfaccia di transazione)
    • Descrizione dettagliata delle due interfacce (pagina di pagamento e interfaccia di transazione) e utilizzo dei parametri
    • Prassi migliore
    • Funzionalità/casi speciali
    • Attivazione/connessione dei metodi di pagamento di terzi (Paypal, Sofort, Billpay)
    • Integrazione CSS e IFrame
    • Integrazione dell’app mobile
    • Carte di prova
    • FAQ

    Documentazione JSON API >>

    Specifiche JSON API:

    Specifiche tecniche, con frammenti di codice ed esempi delle richieste.

    Temi:

    • Codifica del contenuto
    • Autenticazione
    • Gestione degli errori
    • Frammenti di codice server-to-server
    • Esempi di richieste di API (e di URL)
    • Changelog API

    Specifiche JSON API >>

    Assicuratevi di utilizzare l’URL di base dell’ambiente di test corretto!
    Sistema di test dell’URL di base: https://test.saferpay.com/api

    Maggiori informazioni su come creare gli URL delle API corretti sono disponibili nella documentazione Saferpay: http://saferpay.github.io/jsonapi/#integration > Creazione dell’URL delle API corretto

Fase 3: Integrazione nel sistema live

Riceverete tutti i dati necessari per avviare l’integrazione di Saferpay nel vostro sistema live dopo aver configurato con successo il vostro account live. Riceverete un’e-mail dal nostro team di installazione con i seguenti dati:

  • Nome utente Saferpay live (ad es. “e24xxxx001”) per il Saferpay Backoffice
  • Password iniziale Saferpay live per il Saferpay Backoffice - Questa password dovrà essere usata solo una volta, sarete invitati a crearne una nuova dopo il primo accesso. Assicuratevi di utilizzare solo la password appena creata per gli accessi futuri
  • ID del cliente live - Il vostro numero identificativo cliente
  • ID del terminale live - Numero/i identificativo/i del vostro terminale virtuale sul/sui quale/i vengono attivati i diversi metodi di pagamento. Terminali differenti potrebbero avere diversi metodi di pagamenti attivati a seconda delle esigenze della vostra azienda. Inoltre, terminali differenti potrebbero essere utilizzati per negozi online, soggetti o servizi diversi

3.1 Creazione delle credenziali di autorizzazione JSON API

Affinché il vostro sistema comunichi efficacemente con Saferpay API è necessario creare delle credenziali di autenticazione JSON API o dei certificati clienti.

Utilizzate il vostro nome utente Saferpay e la password corrispondente per accedere al Saferpay Backoffice e creare le credenziali JSON API o i certificati cliente.

Dopo aver effettuato il login, accedete alle “Impostazioni” e quindi cliccate su “Autenticazione di base JSON API” o “Certificato cliente JSON API”.

Autenticazione di base JSON API

json
json

Certificati cliente JSON API

json

3.2 Passaggio della vostra integrazione dalla modalità test a quella live

Dopo aver creato le credenziali API JSON o un certificato client API JSON, è sufficiente sostituire i dati di prova con quelli reali.

  • Aggiungete (o sostituite) i vostri dati live nel plugin Saferpay nel backend del vostro negozio.

    Sono richiesti i seguenti dati:

    • ID del cliente live
    • ID del terminale live (terminale e-commerce)
    • Nome utente JSON API live
    • Password JSON API live

    ! Assicuratevi che la modalità operativa dei plugin sia passata alla “Modalità live”

    Plugin live (esempio: WooCommerce)

    Nota: Lo screenshot in alto mostra le impostazioni del plugin WooCommerce. Gli altri plugin per il negozio hanno una grafica diversa, ma richiedono gli stessi dati.

    Per una descrizione più dettagliata dell’integrazione del plugin con Saferpay visitate il sito ufficiale del nostro partner customweb e selezionate il sistema di negozio desiderato.

    Maggiori informazion >>

  • Sostituite i dati di prova con i dati live nei vostri codici/script.

    Sostituite i seguenti valori:

    • ID del cliente
    • ID del terminale (terminale e-commerce)
    • Valori di autenticazione
    • Autenticazione di base con codifica Base 64
      Nome utente JSON API
      Password JSON API
    • O certificati cliente
    • URL di base richiesta API

    Sistema di produzione dell’URL di base:
    https://www.saferpay.com/api
     

    Maggiori informazioni su come creare gli URL delle API corretti sono disponibili nella documentazione Saferpay: http://saferpay.github.io/jsonapi/#integration > “Creazione degli URL delle API corretti”

3.3 Configurazione dei metodi di pagamento di terzi

Assicuratevi di configurare i metodi di pagamento di terzi qualora voleste integrarli a Saferpay. Prestate attenzione anche alle funzionalità speciali di questi metodi di pagamento di terzi.

Questi metodi di pagamento di terzi devono essere configurati prima di essere integrati a Saferpay:

Fase 4: Prova dell’integrazione live

Dovreste testare in modo intensivo la vostra integrazione live con carte e dettagli di pagamento reali per verificare se la configurazione e la funzionalità end-to-end funzionano correttamente.

Il nostro team di integrazione è a vostra disposizione in caso di problemi o altre domande relative all’integrazione.

! Quando si contatta il nostro team di integrazione, si prega di fornire il proprio ID cliente o ID terminale e una descrizione dettagliata dei problemi/errori. Indicate anche se state integrando su un ambiente di prova o live. Quanto più dettagliata sarà la descrizione e i dati forniti, tanto meglio e più rapidamente il nostro team potrà aiutarvi a trovare una soluzione adeguata.

 

Fase 5: Messa in servizio

Dopo aver testato con successo l’integrazione live, potrete ufficialmente passare in modalità live.

Se riscontrate dei problemi mentre il vostro sistema è già in funzione, il nostro team di supporto sarà a vostra completa disposizione e vi assisterà con gentilezza.

! Quando si contatta il nostro team di assistenza, si prega di fornire il proprio ID cliente o ID terminale e una descrizione dettagliata del problema/errore. Quanto più dettagliata sarà la descrizione e i dati forniti, tanto meglio e più rapidamente il nostro team potrà aiutarvi a trovare una soluzione adeguata.