Nota di dismissione: L’integrazione di Docebo con Authorize.net SIM è stata dismessa l'1 Gennaio 2021 e non è più supportata dall'1 Ottobre 2020. Authorize.net Accept Hosted è a disposizione in sostituzione dell'integrazione con Authorize.net SIM, con notevoli vantaggi.
Introduzione
Authorize.net è un gateway di pagamento autorizzato per l'app E-commerce di Docebo e si basa sulla forma di pagamento Accept Hosted (si apre in una nuova scheda).
Requisiti e limitazioni
- Per configurare questa integrazione è necessario disporre di un account venditore valido di Authorize.net.
- Alcune valute supportate da Docebo potrebbero non essere accettate da Authorize.net. 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 Authorize.net nel dominio principale. Se alcuni domini richiedono una configurazione diversa, applicare la configurazione localmente, nella scheda E-Commerce dell'app Extended Enterprise.
Attivare Authorize.net in piattaforma
Attivare l'app Payment Method - Authorize.net Accept Hosted come descritto nell'articolo della knowledge base dedicato alla gestione di applicazioni e funzionalità. L'app si trova nella scheda Integrazione software terzi.
Configurare Authorize.net Accept Hosted in Docebo
Per configurare Authorize.net Accept Hosted, connettersi alla piattaforma come Superadmin, quindi accedere al Menu amministrazione dall’icona ingranaggio in alto a destra e premere Gestione nella sezione Metodo di pagamento - Authorize.net Accept Hosted. Utilizzare le opzione Abilita il gateway di pagamento Authorize.net per attivare questo mezzo di pagamento in piattaforma.
Utilizzare quindi i campi di testo corrispondenti per inserire il Login ID e la Transaction Key. Questi valori autenticano come commerciante autorizzato al momento dell’invio delle richieste di transazioni.
È possibile testare la configurazione prima di utilizzare l’ambiente live, selezionando l’opzione per abilitare la modalità sandbox. Premere Salva le modifiche per terminare.
Recuperare il Login ID e la Transaction key
Il Login ID è un valore complesso della lunghezza minima di otto caratteri, che include lettere maiuscole e minuscole, numeri e/o simboli, e che identifica il proprio account nel gateway di pagamento. Non è lo stesso valore del Login ID per connettersi all'Interfaccia del Venditore in quanto i due valori hanno funzioni diverse. Il Login ID è un ID di Login che Docebo utilizza per comunicare con il gateway di pagamento per gestire le transazioni. È utilizzato unicamente per la connessione di Docebo al gateway di pagamento.
La Transaction key è un valore alfanumerico di 16 caratteri generato casualmente dall'Interfaccia Venditore. Funziona in concomitanza con il Login ID per autenticare gli utenti come utenti autorizzati del gateway di pagamento Authorize.Net quando Docebo invia le transazioni.
Per recuperare queste informazioni, connettersi ad Authorize.net, selezionare Settings nell'area Account nel menu principale, e cliccare API Credentials and Keys nella sezione Security Settings.
Se ancora non sono stati generati il Login ID e la Transaction Key per il proprio account, sarà necessario inserire la risposta segreta alla domanda segreta configurata durante il processo di attivazione. Premere Submit per terminare.
Attenzione! Il valore Transaction Key dell'account sarà visualizzato sulla pagina di conferma. Abbandonando la pagina, non sarà più possibile accedere al Transaction Key dall'interfaccia di Authorize.net.
Sarà necessario generare un nuovo Transaction Key. Consigliamo vivamente di generare regolarmente una nuova Transaction Key (ad esempio, ogni 6 mesi) per rendere più sicuro l'account del gateway di pagamento. Salvare il valore transaction key nell'area corrispondente della piattaforma per aggiornare il codice di integrazione. L'inadempienza risulterà nell'interruzione dell'elaborazione delle transazioni.
Configurare l'URL di relay response in Authorize.net
Configurare infine l'URL di Response. Accedere alla scheda Account. Nella sezione Transaction Format Settings, cliccare Response/Receipt URLs. Configurare l'URL nel campo Default Receipt URL premendo Edit nella riga corrispondente e inserendo l'URL della propria piattaforma; questa configurazione è obbligatoria. La configurazione del Default Relay Response URL è facoltativa ma consigliamo di eseguirla se la logica di business implementata in Authorize.net lo consente. Una volta inserito l'URL per il Default Relay Response, non sarà più possibile modificarlo.
Gli utenti del tema 7.0 con un dominio personalizzato, dovranno inserire l'URL del dominio personalizzato. Gli utenti del tema 6.9, continueranno ad utilizzare l'URL docebosaas. Gli esempi che seguono aiuteranno nella configurazione (le informazioni fra parentesi dovranno essere sostituite con i dati della propria piattaforma).
-
Dominio personalizzato:
https://[custom_domain]/ecommerce/v1/authorizedotnet/relay_response -
Dominio standard:
https://[mylms].docebosaas.com/ecommerce/v1/authorizedotnet/relay_response - Dominio Extended Enterprise:
https://[mylms].docebosaas.com/[extendedenterprisedomainfoldername]/ecommerce/v1/authorizedotnet/relay_response
Nota sulla dismissione dell’algoritmo MD5
Authorize.net ha introdotto l’algoritmo di cifratura SHA2 il 29 Gennaio 2019, e dismesso l’algoritmo a fine Giugno 2019. Le integrazioni esistenti continueranno a funzionare senza interruzioni, e l’algoritmo in uso continuerà ad essere MD5. Le chiavi esistenti continueranno ad essere crittografate con l’hash MD5, ma consigliamo di passare a SHA2 il prima possibile. Attenzione: anche se l'interfaccia di Docebo permette di tornare a MD5 dopo aver selezionato SHA2, Authorize.net non lo permette, e il rollback causerebbe delle inconsistenze nelle chiavi.
Suggerimenti
- Quando si seleziona Authorize.net come mezzo di pagamento di una transazione e-commerce, il totale dei caratteri inseriti nei campi Indirizzo 1 e Indirizzo 2 nel pannello Informazioni di Fatturazione al momento della finalizzazione del pagamento non deve superare 60. Authorize.net non gestisce indirizzi con più di 60 caratteri.
- Il campo Invoice di Authorize.net indica un codice fattura univoco interno di Docebo per ogni transazione eseguita in Docebo Learn per impedire la creazione di transazioni duplicate.
- Quando un utente paga tramite Authorize.net ma chiude la scheda del browser prima di tornare alla pagina di conferma della piattaforma, l'amministratore dovrà verificare manualmente la transazione nel portale di Authorize.net.