Introduzione
Cybersource è un gateway di pagamento autorizzato per l'app E-Commerce di Docebo.
Requisiti e Limitazioni
- Alcune valute supportate da Docebo potrebbero non essere accettate da Stripe. Controllare che le valute di interesse siano gestite da entrambi i sistemi prima di procedere. Elenco completo delle valute supportate da Docebo.
- Se si utilizza l'Extended Enterprise, configurare le impostazioni di Cybersource nel dominio principale. Se alcuni domini richiedono una configurazione diversa, applicare la configurazione localmente, nella scheda E-Commerce dell'app Extended Enterprise.
Configurare un Profilo Docebo in Cybersource
Per configurare l'integrazione tra Docebo e Cybersource, creare innanzitutto un profilo Docebo in Cybersource. A tal scopo, connettersi a Cybersource, cliccare Payment Configuration nel menu di sinistra, quindi selezionare Secure Acceptance Settings. Nella pagina che si apre, sono elencati tutti i profili già disponibili. Cliccare New Profile per procedere.
Nel pannello che si apre sulla destra della pagina (Create Profile), inserire nome e descrizione del profilo, quindi impostare Hosted Checkout nella sezione Integration Methods. Completare i campi seguenti, quindi assicurarsi che le opzioni Payment Tokenization e Decision Manager non siano selezionate. Cliccare Submit in fondo al pannello per iniziare il processo di creazione. Si accederà automaticamente all'area di configurazione del profilo.
A questo punto, generare una chiave di sicurezza (security key) per il proprio profilo. Spostarsi nella scheda Security e cliccare il bottone più nell'area Security Key per creare una nuova chiave di sicurezza. Definire un nome per la chiave, quindi configurare il valore 1 nel campo Signature Version e HMAC_SHA256 nel campo Signature Method. Premere Confirm per confermare la creazione della chiave.
Al termine della procedura di creazione, Cybersource mostrerà Secret Key e Access Key, necessarie per configurare l'integrazione tra Docebo e Cybersource. È possibile accedere a queste chiavi in qualsiasi momento, selezionando la chiave tramite la casella di spunta corrispondente e cliccando l'icona occhio. Le chiavi hanno un periodo di validità di 2 anni.
Per terminare la configurazione del gateway di pagamento, configurare i Payment Settings obbligatori. Sarà possibile definire i metodi di pagamento preferiti e le informazioni richieste a chi acquista.
Spostarsi nella scheda Customer Response, impostare Hosted by You per entrambe le opzioni Transaction Response Page e Custom Cancel Response Page, e configurarle come segue:
Dominio Standard:
- Transaction Response Page = https://[platform_name].docebosaas.com/ecommerce/v1/cybersource/validate
- Custom Cancel Response Page = https://[platform_name].docebosaas.com/ecommerce/v1/cybersource/decline
Dominio Extended Enterprise
- Transaction Response Page = https://[platform_name].docebosaas.com/[domain_name]/ecommerce/v1/cybersource/validate
- Custom Cancel Response Page = https://[platform_name].docebosaas.com/[domain_name]/ecommerce/v1/cybersource/decline
Custom Domain
- Transaction Response Page = https://[custom_domain].docebosaas.com/[domain_name]/ecommerce/v1/cybersource/validate
- Custom Cancel Response Page = https://[custom_domain].docebosaas.com/[domain_name]/ecommerce/v1/cybersource/decline
Attivare Cybersource in Docebo
Attivare l'app Payment Method - Cybersource come descritto nell'articolo della Knowledge Base dedicato alla gestione di applicazioni e funzionalità. L'app si trova nella scheda Integrazione Software Terzi.
Configurare Cybersource
Per configurare Cybersource, connettersi alla piattaforma come Superadmin, accedere al Menu Amministrazione dall’icona ingranaggio in alto a destra, e cliccare Gestione nella sezione Metodo di Pagamento - Cybersource. Selezionare Abilita il gateway di pagamento Cybersource per abilitare il gateway.
Digitare la access key, il secret key e il Profile ID di Cybersource nei campi di testo corrispondenti (le istruzioni su come recuperare queste informazioni sono dettagliate in seguito). È possibile testare la configurazione prima di utilizzare l’ambiente live, selezionando l’opzione per abilitare la modalità sandbox.
Attenzione! Attualmente, selezionando la modalità sandbox, Cybersource accetta solo dollari statunitensi. Se l'opzione sandbox non è selezionata, il gateway di pagamento accetta tutte le valute.
Consigli d'Utilizzo
- Quando si utilizza Cybersource come mezzo di pagamento per le transazioni e-commerce, assicurarsi che
- gli utenti siano al corrente che il campo Stato/Provincia/Regione nel pannello Informazioni di Fatturazione visualizzato al momento della finalizzazione del pagamento sia un codice a due lettere
- il nome dell'utente che finalizza il pagamento non deve includere i doppi apici (" ")