Configurare i metodi di pagamento del self service nella Member Platform e nella Branded App

In questo articolo imparerai a configurare e controllare i metodi di pagamento avanzati del self service per i tuoi abbonati nella Member Platform e nella Branded App, e come i partner tecnici possono integrare il componente di pagamento.

Contenuto

• Requisiti

• Attivare i metodi di pagamento del self service

• Controllare i metodi di pagamento disponibili

• Limitare i metodi di pagamento dei pagamenti ricorrenti

• Come i tuoi abbonati usano il self service

• Integrazione per partner tecnici (Payment API)

Fast Lane

1. Attiva Finion Pay da Impostazioni / Finion Financial Solutions / Finion Pay.
2. Vai su MySports / Gestione del servizio / Area Self / <nome della configurazione>, attiva i dati di pagamento, imposta il conto dell'abbonato su «Compensazione consentita» e configura il Fast Finance Link.

Requisiti

Prima di poter attivare i metodi di pagamento avanzati nel self service devono essere soddisfatte queste condizioni:

• Finion Pay deve essere attivo. Attiva il servizio da Impostazioni / Finion Financial Solutions / Finion Pay. L'integrazione sarà disponibile entro 5 giorni lavorativi.

• La Member Platform deve essere attiva. Il tuo centro necessita di un accesso attivo alla Member Platform (app e/o web).

Nota: senza l'estensione Finion Pay attiva, i metodi di pagamento avanzati (per esempio carta di credito, TWINT o BACS) non sono disponibili nel self service.

Attivare i metodi di pagamento del self service

Tutta la configurazione dei metodi di pagamento del self service avviene in MySports / Gestione del servizio / Area Self. Seleziona lì la configurazione desiderata. All'interno della configurazione sono rilevanti tre aree:

a) Dati personali degli abbonati: attivare i dati di pagamento

• Nella sezione Dati personali degli abbonati, assicurati che Dettagli di pagamento sia attivato.

• Consenti la modifica dei dati di pagamento, così i tuoi abbonati possono aggiornare i propri metodi di pagamento autonomamente.

b) Dati aggiuntivi: attivare il conto dell'abbonato e la compensazione online

• Nel widget dei dati aggiuntivi, apri la finestra di modifica del conto dell'abbonato dal menu a tre puntini.

• Imposta la compensazione su Compensazione consentita. Così i tuoi abbonati possono saldare i debiti aperti dal self service.

• Facoltativo: sotto Tassa di pagamento online puoi definire una commissione per la procedura di pagamento online (per esempio come importo fisso o come percentuale). Il valore predefinito è 0,00 €.

• Fai clic su Salva.

c) Fast Finance Link: configurare passaggi, ordine e tipi di pagamento

• All'interno della stessa configurazione del self service, vai alla sezione Fast Finance Link.

• Nelle funzioni attivate, seleziona l'opzione desiderata per Passaggi attivi e ordine:

  • Pagamento dei debiti aperti → Aggiornamento modalità di pagamento (consigliato)
  • Pagamento solo dei debiti aperti
  • Aggiornamento modalità di pagamento → Pagamento dei debiti aperti
  • Solo aggiornamento del metodo di pagamento
  • Disabilitato

• Stabilisci quali metodi di pagamento devono essere disponibili nel self service per la compensazione e per l'aggiornamento.

• Salva la configurazione.

Controllare i metodi di pagamento disponibili

Sei tu a decidere quali metodi di pagamento sono a disposizione dei tuoi abbonati nel self service. Il controllo avviene dalla configurazione del software. A seconda del paese e della tua configurazione di Finion Pay possono essere disponibili i seguenti metodi di pagamento:

• Addebito diretto SEPA, per la regione DACH e altri mercati europei.

• Carta di credito, Visa, Mastercard e altre carte diffuse.

• TWINT, per i centri in Svizzera.

• Addebito diretto BACS, per i centri nel Regno Unito.

Per vedere quali metodi di pagamento sono abilitati per il tuo centro, vai su Impostazioni / Finion Financial Solutions / Finion Pay / Metodi di pagamento.

Consiglio: se vuoi offrire la carta di credito come metodo di pagamento anche nelle offerte contrattuali, configuralo in aggiunta sotto Impostazioni / Conclusione del contratto / Offerte contrattuali / Opzioni di offerta.

Limitare i metodi di pagamento dei pagamenti ricorrenti

Una seconda impostazione stabilisce quali metodi di pagamento i tuoi abbonati possono scegliere quando aggiornano il loro metodo di pagamento ricorrente nel self service. Usala quando i tuoi abbonati devono poter passare solo a un conto bancario, mentre la carta di credito resta disponibile per i pagamenti online singoli.

Il widget Dati personali degli abbonati mostra quali metodi di pagamento i tuoi abbonati possono attualmente memorizzare.

1. Vai su MySports / Gestione del servizio / Area Self e apri la configurazione che vuoi modificare.
2. Nel widget Dati personali degli abbonati, fai clic su Modificare.
3. Imposta Dettagli di pagamento su Controllare le modifiche o Accettare direttamente le modifiche. Il campo successivo compare solo in questi due stati.
4. In Metodi di pagamento disponibili, seleziona tutti i metodi che un abbonato può memorizzare come metodo di pagamento ricorrente e rimuovi quelli che non vuoi, per esempio Carta di credito.
5. Salva la configurazione.

Rimuovi un metodo da Metodi di pagamento disponibili affinché i tuoi abbonati non possano più sceglierlo come metodo di pagamento ricorrente.

Che cosa cambia questa impostazione e che cosa lascia intatto:

Importante: non lasciare il campo vuoto. Una selezione vuota non significa «tutti i metodi di pagamento». In quel caso i tuoi abbonati non possono più aggiornare il proprio metodo di pagamento, e la schermata di pagamento del self service restituisce un errore invece del modulo. Seleziona sempre almeno un metodo.

Nota: i metodi selezionabili dipendono dal paese e dalla valuta del tuo centro e dalla configurazione del tuo servizio di pagamento. TWINT, per esempio, viene offerto solo ai centri in Svizzera, e la carta di credito solo quando il relativo servizio di pagamento è attivo.

Non confondere questo campo con il campo Metodi di pagamento disponibili dallo stesso nome nella configurazione del Fast Finance Link descritta sopra. Il campo del Fast Finance Link controlla i metodi all'interno del percorso Fast Finance Link; questo controlla ciò che i tuoi abbonati possono memorizzare come metodo di pagamento ricorrente.

Come i tuoi abbonati usano il self service

Una volta completata la configurazione, i tuoi abbonati possono gestire i propri dati di pagamento autonomamente:

• Member Platform (app): nell'area self service dell'app, i tuoi abbonati possono aggiungere o aggiornare il proprio metodo di pagamento. L'inserimento avviene tramite un componente di pagamento sicuro e cifrato.

• Branded App: la stessa funzione è disponibile anche nella tua Branded App.

• Member Web: i tuoi abbonati possono aggiornare i propri dati di pagamento anche dalla Member Web.

Importante: i dati della carta di credito che un abbonato memorizza tramite l'app non possono essere consultati né gestiti dal centro. Solo l'abbonato ha accesso a queste informazioni.

Per metodi di pagamento come la carta di credito può essere necessaria un'autenticazione aggiuntiva (per esempio 3D Secure). In questo caso l'abbonato viene reindirizzato alla propria banca e riportato automaticamente indietro al termine.

Integrazione per partner tecnici (Payment API)

Per i partner tecnici che vogliono integrare il componente di pagamento nella propria applicazione è disponibile la Payment API. L'integrazione avviene in due passaggi:

Passaggio 1: creare la User Payment Session. Tramite l'endpoint POST /v1/payments/user-session viene generato un token di sessione di breve durata. Questo token autorizza il componente di pagamento nel frontend. I parametri rilevanti sono:

• amount: l'importo del pagamento. Imposta il valore a 0 se deve essere solo memorizzato un metodo di pagamento.

• scope: il contesto di pagamento. MEMBER_ACCOUNT per i pagamenti ricorrenti oppure ECOM per gli acquisti e-commerce.

• customerId oppure finionPayCustomerId: l'identificazione del cliente. Usa esattamente uno dei due parametri.

• permittedPaymentChoices: limitazione facoltativa dei metodi di pagamento offerti (per esempio CREDIT_CARD o PAYPAL). Se questo parametro non viene impostato, vengono offerti tutti i metodi tecnicamente disponibili.

• referenceText: il testo di riferimento che compare sull'estratto conto dell'abbonato.

Scope necessario: PAYMENT_WRITE

Passaggio 2: integrare il componente di pagamento (widget). Il componente di pagamento è un widget JavaScript integrabile. Includi lo script del widget e lo inizializzi con il token di sessione ricevuto:

<script src="WIDGET_URI"></script>
<div id="payment-widget"></div>

<script>
const widget = window.paymentWidget.init({
    userSessionToken: 'your-session-token',
    environment: 'live',
    countryCode: 'IT',
    locale: 'it-IT',
    container: 'payment-widget',
    onSuccess: (paymentRequestToken) => {
        // Usare il token per l'elaborazione successiva
    }
});
</script>

Il widget supporta personalizzazioni tramite i parametri di stile (colori, bordi) e i18n (traduzioni). Nella documentazione trovi esempi di integrazione specifici per framework (React, Angular, Vue.js).

Note importanti sull'elaborazione del token:

• Il paymentRequestToken restituito dal widget può essere usato per memorizzare un metodo di pagamento del cliente o per avviare un pagamento.

• Finché il token non viene usato per una prenotazione non viene addebitato alcun importo. L'autorizzazione viene annullata automaticamente alla scadenza del token di sessione associato.

• Per ogni User Payment Session può essere riscattato un solo token.

La documentazione completa dell'API, endpoint ed esempi inclusi, si trova nel Developer Portal.

Avviso: Questo articolo è stato tradotto con l'aiuto dell'intelligenza artificiale. Ci scusiamo per eventuali errori.