Documentazione

1Registrazione

Per iniziare a elaborare pagamenti tramite PostFinance (PostFinanza E-Pagamento E-Commerce) devi prima ottenere un account esercente. In questo modo otterrai un PSPID e una password.

Il gestore E-Commerce di PostFinance (PostFinanza E-Pagamento E-Commerce) è il gestore standard per PostFinance (PostFinanza E-Pagamento E-Commerce). Consente l’elaborazione dei pagamenti tramite le pagine di pagamento di PostFinance (PostFinanza E-Pagamento E-Commerce). Ciò significa che, se desideri elaborare carte di credito senza reindirizzamento alla pagina di pagamento di PostFinance (PostFinanza E-Pagamento E-Commerce), devi utilizzare il gestore DirectLink. Lo stesso vale se desideri utilizzare le funzionalità antifrode nell’applicazione per l’elaborazione OnSite.

2Configurazione

Nella seguente documentazione trovi una panoramica della configurazione del gestore PostFinance (PostFinanza E-Pagamento E-Commerce). Segui la guida passo dopo passo per configurare il tuo account. Nel caso in cui un’impostazione non venga menzionata esplicitamente, lasciala invariata, non ha alcun effetto sulla configurazione.

2.1Configurare il gestore nell’applicazione

Innanzitutto devi creare una configurazione del gestore nell’applicazione. Vai a Space > Pagamento > Configurazione > Gestore per creare un nuovo gestore. Nel caso in cui PostFinance (PostFinanza E-Pagamento E-Commerce) non sia visibile nell’elenco, inizia a digitare il nome e dovrebbe apparire. Fai clic su continua per avviare la configurazione.

Successivamente devi impostare un PSPID, un algoritmo di hash e una passphrase SHA-IN e SHA-OUT. Ti consigliamo di utilizzare frasi SHA-IN e SHA-OUT diverse e di utilizzare SHA-512 come algoritmo di hash.

2.2Configurare il gestore PostFinance (PostFinanza E-Pagamento E-Commerce)

Ora vai al backend PostFinance (PostFinanza E-Pagamento E-Commerce). Accedi con il tuo PSPID e la tua password e vai a Configuration > Technical Information.

La sezione successiva riporta il nome delle schede di configurazione e ti indica per ogni scheda di configurazione cosa deve essere impostato.

2.2.1TAB: Your technical Settings

Questa scheda può essere ignorata. È solo una panoramica delle tue impostazioni.

2.2.2TAB: Global transaction parameter

Le impostazioni dei parametri di transazione globali sono impostazioni globali per l’elaborazione dei tuoi pagamenti. Normalmente non è necessario modificare nulla qui. Dai un’occhiata allo screenshot qui sotto che mostra le impostazioni standard.

Global Transaction Parameter
Figure 1. Impostazioni Global Transaction Parameter

2.2.3TAB: Global Security Parameter

In questa scheda imposti l’algoritmo di hash e la codifica. Assicurati di impostare l' algoritmo di hash in modo identico (ti consigliamo di impostarlo su SHA-512) rispetto alle impostazioni del tuo gestore e la codifica su UTF-8.

2.2.4TAB: Payment Page

Lascia tutto vuoto.

Global Transaction Parameter
Figure 2. Impostazioni Payment Page

2.2.5TAB: Data and origin verification

Questa scheda imposta la sicurezza per la chiamata della pagina di pagamento di PostFinance (PostFinanza E-Pagamento E-Commerce). Anche qui devi assicurarti di impostare la passphrase SHA-IN in modo identico alle impostazioni del tuo gestore nell’applicazione.

Data Origin
Figure 3. Data and origin verification per PostFinance (PostFinanza E-Pagamento E-Commerce) E-Commerce

2.2.6TAB: Transaction Feedback

Questa scheda contiene le impostazioni per il feedback delle transazioni riuscite o non riuscite verso la piattaforma:

  • Lascia il campo HTTP redirection in the browser URLs vuoto.

  • Assicurati di selezionare l’impostazione I would like to receive transaction feedback parameters on the redirection URLs.

Data Origin
Figure 4. Impostazioni di reindirizzamento HTTP nel browser. Assicurati di selezionare le caselle.

Per la richiesta diretta HTTP server-to-server imposta il parametro su Always online (immediately after the payment to allow customization of the response seen by the customer). oppure, nel caso in cui questa impostazione non sia disponibile, impostala su Online but switch to a deferred request when the online requests fail.

Nel campo URL of the merchant post-payment page inserisci il seguente URL:

Data Origin
Figure 5. Impostazioni della richiesta HTTP server-to-server. Può darsi che i campi mostrati qui differiscano leggermente dal tuo account.

I parametri e-commerce dinamici possono essere tutti spostati sul selected side. E assicurati di impostare la firma SHA-OUT esattamente come nell’applicazione.

Per la HTTP request for status changes seleziona l’opzione For each offline status change (payment, cancellation, etc.). e inserisci nel campo di input sottostante il seguente URL:

2.2.7TAB: Transaction e-mails

Nel caso in cui desideri ricevere un’e-mail per la transazione elaborata, puoi impostare qui il tuo indirizzo e-mail e verrai notificato ogni volta che ricevi un pagamento.

2.2.8TAB: Test info

In questa scheda puoi impostare la strategia di test e vedi i dettagli di pagamento di test per i tipi di pagamento nel tuo account.

3Configurare il tipo di pagamento e il connettore

Una volta che tutto è configurato nel backend di PostFinance (PostFinanza E-Pagamento E-Commerce), puoi continuare a creare i tipi di pagamento (se non l’hai già fatto) in Space > Pagamento > Configurazione > Tipo di pagamento.

Dopo che il tipo di pagamento è stato creato, puoi collegare la configurazione del gestore e il tipo di pagamento nella configurazione del connettore Space > Pagamento > Configurazione > Connettore.