Documentazione

1Il concetto di base dei gestori

È importante avere una comprensione chiara dei diversi termini e del loro significato. È particolarmente importante che comprendiate la differenza e il modo in cui questi concetti sono collegati tra loro. In particolare la differenza tra tipo di pagamento, gestore e connettore.

1.1Anatomia

Affinché un tipo di pagamento appaia sulla pagina di pagamento, le seguenti entità devono essere configurate correttamente:

  • Gestore: Un processor rappresenta una singola integrazione verso una terza parte in grado di elaborare pagamenti. Per ogni processor deve essere creata una configurazione per poter accettare pagamenti tramite il processor.

  • Tipo di pagamento: Un payment method rappresenta un singolo mezzo con cui un cliente può pagare. Un payment method può anche essere configurato per controllare proprietà specifiche del payment method. Per accettare pagamenti con un determinato tipo di pagamento, deve essere creata una configurazione per questo payment method.

  • Connettore: Un connector collega il payment method con il processor. È come una singola connessione verso il processor. Un processor dispone di un insieme definito di connectors. Per utilizzare un connector è necessario configurarlo. Il connector esegue effettivamente il pagamento e quindi avete bisogno della configurazione del connector per accettare pagamenti.

Per ognuna di queste entità potete naturalmente avere più configurazioni. Potete anche avere più configurazioni dello stesso tipo e separarle tramite condizioni oppure collegarle a una specifica vista dello spazio.

1.2Gestore

Potete creare una configurazione di gestore in Space > Pagamento > Configurazione > Gestori.

Un gestore rappresenta l’integrazione API verso una terza parte. L’elenco dei gestori mostra tutti i gestori supportati.

Nella configurazione del gestore potete generalmente definire le seguenti impostazioni:

  • Attivare o disattivare la configurazione del gestore. Quando la configurazione del gestore è disattivata, tutte le configurazioni di connettore collegate alla configurazione del gestore non vengono più prese in considerazione per l’autorizzazione delle transazioni. Una configurazione disattivata può essere riattivata.

  • Passare dalla modalità live alla modalità test e viceversa.

  • Impostare le credenziali per utilizzare l’API del gestore. Si tratta ad esempio delle credenziali fornite dal gestore.

Potete avere più istanze dello stesso gestore. Ciò consente di utilizzare più account dello stesso gestore. In questo modo è possibile utilizzare account diversi a seconda di una proprietà della transazione (ad esempio importo, paese ecc.).

Esempio

Utilizzare terminali diversi in base a un criterio specifico:

Se desiderate utilizzare un gestore diverso in base a un criterio della transazione (ad esempio l’importo della transazione), potete applicare le condizioni sulla rispettiva configurazione di connettore (vedi sotto) per selezionare il fornitore di servizi di pagamento corretto.

1.3Tipi di pagamento

Per creare una configurazione per un tipo di pagamento andate su Space > Pagamento > Configurazione > Tipi di pagamento.

Una configurazione del tipo di pagamento definisce come viene elaborato il pagamento. Supportiamo una moltitudine di tipi di pagamento diversi. Tenete presente che non tutti i tipi di pagamento possono essere elaborati da tutti i gestori. L’elenco dei tipi di pagamento mostra tutti i tipi di pagamento supportati.

Nella configurazione del tipo di pagamento potete generalmente definire le seguenti impostazioni:

  • Attivare e disattivare una configurazione del tipo di pagamento. Quando una configurazione del tipo di pagamento è disattivata, questa configurazione del tipo di pagamento non viene più utilizzata per l’autorizzazione delle transazioni. Una configurazione disattivata può essere riattivata.

  • Definire il nome del tipo di pagamento mostrato al cliente.

  • Definire l’ordine in cui il tipo di pagamento viene mostrato al cliente.

  • Definire l’immagine utilizzata per il tipo di pagamento.

  • Alcuni tipi di pagamento consentono la raccolta delle informazioni di pagamento direttamente sulla nostra pagina di pagamento. In questo caso potete scegliere se preferite raccogliere i dati sulla pagina di pagamento della terza parte (offsite) oppure se dobbiamo raccogliere noi i dati (onsite). Questa opzione appare solo quando potete controllare questo aspetto per un determinato tipo di pagamento. Non tutti i connettori di pagamento supportano entrambe le modalità di raccolta dei dati, quindi potreste voler verificare prima se il vostro connettore preferito supporta il tipo di raccolta dati selezionato. Una volta impostato il tipo di raccolta dati su una configurazione del tipo di pagamento, non può più essere modificato.

Potete creare più configurazioni dello stesso tipo di pagamento.

1.4Configurazioni di connettore

Per creare una configurazione di connettore andate su Space > Pagamento > Configurazione > Connettori.

Una configurazione di connettore collega le caratteristiche dei tipi di pagamento con le capacità del vostro gestore (ossia non tutti i tipi di pagamento possono essere elaborati da tutti i gestori di pagamento. Alcuni gestori possono elaborare determinati tipi di pagamento solo offsite oppure solo onsite).

Le impostazioni disponibili dipendono in larga misura dalle capacità del connettore e dalle caratteristiche del tipo di pagamento.

Nella configurazione del tipo di pagamento potete generalmente definire le seguenti impostazioni:

  • Attivare e disattivare la configurazione del connettore. Una configurazione di connettore disattivata non viene presa in considerazione per l’autorizzazione delle transazioni. Una configurazione disattivata può essere riattivata.

  • L’ordine in cui i connettori vengono applicati alle transazioni.

  • Le condizioni che vengono applicate al connettore. Ciò consente di controllare in quali circostanze il connettore verrà utilizzato.

  • Limitare il connettore a un insieme di viste dello spazio.

  • Il modello di e-mail di autorizzazione e il modello di e-mail di fattura.

  • Il modello di fattura applicato alle transazioni di questo connettore.

  • Impostazioni specifiche del connettore, come le impostazioni antifrode.

Per collegare il vostro tipo di pagamento configurato al gestore, potete creare una configurazione di connettore separata per ognuno dei casi previsti.

Esempio

Utilizzare terminali diversi in base a un criterio specifico

Se desiderate utilizzare un gestore diverso in base a un criterio della transazione (ad esempio l’importo della transazione), potete creare più configurazioni e poi applicare le condizioni nella rispettiva configurazione di connettore.

2Applicare condizioni sui connettori

Le condizioni sono il nostro modo di selezionare una configurazione di connettore per una transazione. Potete creare configurazioni di condizione in Space > Pagamento > Configurazione > Condizioni.

Le condizioni possono essere impostate in base a più criteri della transazione. L’elenco dei tipi di condizione mostra tutti i tipi possibili. Ogni tipo definisce criteri diversi per filtrare le transazioni. Queste condizioni possono anche essere raggruppate in un gruppo logico or, il che consente di formulare condizioni complesse.

Le condizioni sono gestite in modo centralizzato perché possono essere applicate a più configurazioni, come:

  • Configurazione di connettore: le condizioni agiscono qui come meccanismo per l’instradamento delle transazioni.

  • Configurazione di charge flow: le condizioni controllano quale flusso viene applicato alla transazione.

Note
Se dopo l’applicazione di una condizione rimangono ancora più opzioni, la selezione viene effettuata in base alla priorità definita nella configurazione. L’applicazione delle condizioni e la priorità consentono di definire un instradamento delle transazioni.

3Raccolta dei dati di pagamento

Le informazioni di pagamento possono essere raccolte tramite il nostro modulo di pagamento ospitato (onsite) oppure possiamo reindirizzare il cliente al gestore per la raccolta dei dati (offsite).

  • La raccolta dati onsite implica che il modulo di raccolta dati viene generato da noi e quindi può essere personalizzato modificando i corrispondenti elementi del modulo tramite l’editor delle risorse.

  • La raccolta dati offsite implica che la personalizzazione del modulo deve essere effettuata tramite gli strumenti del gestore.

Note
Alcuni tipi di pagamento supportano solo una delle due modalità di raccolta. In questo caso la configurazione del tipo di pagamento può essere impostata per la raccolta dati offsite oppure onsite. Ciò significa che, a seconda della configurazione del tipo di pagamento, può accadere che non possiate selezionare qualsiasi gestore quando impostate la vostra configurazione di connettore.
Staging 2.218.3