Overslaan en naar hoofdcontent gaan

Betaalmethoden van de self-service instellen in de Member Platform en de Branded App

  • Bijgewerkt

In dit artikel leer je hoe je de geavanceerde betaalmethoden van de self-service voor je leden instelt en aanstuurt in de Member Platform en de Branded App, en hoe technische partners de betaalcomponent kunnen integreren.

Inhoud

Fast Lane

  1. Activeer Finion Pay via Instellingen / Finion Financial Solutions / Finion Pay.
  2. Ga naar MySports / Administratie / Self-Service / <naam van de configuratie>, activeer de betaalgegevens, zet het ledenaccount op «Verrekening toegestaan» en configureer de Fast Finance Link.

Voorwaarden

Voordat je de geavanceerde betaalmethoden in de self-service kunt activeren, moet aan deze voorwaarden zijn voldaan:

  • Finion Pay moet actief zijn. Activeer de dienst via Instellingen / Finion Financial Solutions / Finion Pay. De integratie is binnen maximaal 5 werkdagen beschikbaar.

  • De Member Platform moet actief zijn. Je club heeft actieve toegang tot de Member Platform (app en/of web) nodig.

Let op: zonder actieve Finion Pay-uitbreiding zijn de geavanceerde betaalmethoden (bijvoorbeeld creditcard, TWINT of BACS) niet beschikbaar in de self-service.

Betaalmethoden van de self-service activeren

De volledige configuratie van de betaalmethoden van de self-service gebeurt in MySports / Administratie / Self-Service. Selecteer daar de gewenste configuratie. Binnen de configuratie zijn drie gebieden relevant:

a) Persoonlijke lidmaatschapsgegevens: betaalgegevens activeren

  • Zorg er in het gedeelte Persoonlijke lidmaatschapsgegevens voor dat Betaalgegevens geactiveerd is.

  • Sta het wijzigen van de betaalgegevens toe, zodat je leden hun betaalmethoden zelf kunnen bijwerken.

b) Aanvullende gegevens: ledenaccount en online verrekening activeren

  • Open in de widget met de aanvullende gegevens het dialoogvenster voor het bewerken van het ledenaccount via het menu met drie puntjes.

  • Zet de verrekening op Verrekening toegestaan. Zo kunnen je leden openstaande vorderingen via de self-service voldoen.

  • Optioneel: onder Online betaling kun je een vergoeding voor het online betaalproces vastleggen (bijvoorbeeld als vast bedrag of als percentage). De standaardwaarde is € 0,00.

  • Klik op Opslaan.

c) Fast Finance Link: stappen, volgorde en betaaltypen configureren

  • Ga binnen dezelfde self-serviceconfiguratie naar het gedeelte Fast Finance Link.

  • Kies bij de geactiveerde functies de gewenste optie voor Actieve stappen en volgorde:

    • Betaling van openstaande schulden → Update van de betalingsmethode (aanbevolen)
    • Alleen betaling van openstaande schulden
    • Update betalingsmethode → Betaling van openstaande schulden
    • Alleen update van betaalmethode
    • Gedeactiveerd

  • Bepaal welke betaalmethoden in de self-service beschikbaar moeten zijn voor de verrekening en de update.

  • Sla de configuratie op.

Beschikbare betaalmethoden aansturen

Jij bepaalt welke betaalmethoden je leden in de self-service ter beschikking staan. Dit stuur je aan vanuit de softwareconfiguratie. Afhankelijk van je land en je Finion Pay-configuratie kunnen de volgende betaalmethoden beschikbaar zijn:

  • SEPA-incasso, voor de DACH-regio en andere Europese markten.

  • Creditcard, Visa, Mastercard en andere gangbare kaarten.

  • TWINT, voor clubs in Zwitserland.

  • BACS-incasso, voor clubs in het Verenigd Koninkrijk.

Ga naar Instellingen / Finion Financial Solutions / Finion Pay / Betaalmethoden om te zien welke betaalmethoden voor je club zijn ingeschakeld.

Tip: wil je de creditcard ook als betaalmethode in contractaanbiedingen aanbieden, configureer dat dan aanvullend onder Instellingen / Contract afsluiten / Contractaanbiedingen / Contract opties.

Betaalmethoden voor terugkerende betalingen beperken

Een tweede instelling bepaalt welke betaalmethoden je leden kunnen kiezen wanneer ze hun terugkerende betaalmethode in de self-service bijwerken. Gebruik hem wanneer je leden alleen naar een bankrekening mogen overstappen, terwijl de creditcard beschikbaar blijft voor eenmalige online betalingen.

Self-serviceconfiguratie met de widget Persoonlijke lidmaatschapsgegevens en de regel Beschikbare betaalmethoden

De widget Persoonlijke lidmaatschapsgegevens laat zien welke betaalmethoden je leden op dit moment kunnen opslaan.

  1. Ga naar MySports / Administratie / Self-Service en open de configuratie die je wilt wijzigen.
  2. Klik in de widget Persoonlijke lidmaatschapsgegevens op Bewerken.
  3. Zet Betaalgegevens op Controleer wijzigingen of Veranderingen direct toepassen. Het volgende veld verschijnt alleen in deze twee toestanden.
  4. Selecteer in Beschikbare betaalmethoden alle methoden die een lid als terugkerende betaalmethode mag opslaan, en verwijder de methoden die je niet wilt, bijvoorbeeld Creditcard.
  5. Sla de configuratie op.

Dialoogvenster voor het bewerken van de persoonlijke lidmaatschapsgegevens met de meervoudige selectie Beschikbare betaalmethoden

Verwijder een methode uit Beschikbare betaalmethoden zodat je leden hem niet meer als terugkerende betaalmethode kunnen kiezen.

Wat deze instelling verandert en wat ze onaangeroerd laat:

Beïnvloed door deze instelling Niet beïnvloed
Het bijwerken van de terugkerende betaalmethode in de Member Platform (app en web) en in de Branded App. Eenmalige online betalingen, bijvoorbeeld het voldoen van openstaande vorderingen, inschrijfkosten bij een online inschrijving of een aankoop in de shop. Daar blijven alle voor je club ingeschakelde methoden beschikbaar.
Het betaalformulier dat je leden zelf openen in de self-service. Betaalmethoden die je medewerkers voor een lid in de software vastleggen. Je team kan nog steeds een creditcard opslaan, ook als die in de self-service niet te kiezen is.

Belangrijk: laat het veld niet leeg. Een lege selectie betekent niet «alle betaalmethoden». Je leden kunnen hun betaalmethode dan helemaal niet meer bijwerken, en het betaalscherm van de self-service geeft een foutmelding in plaats van het formulier. Selecteer altijd minstens één methode.

Let op: welke methoden je kunt selecteren hangt af van het land en de valuta van je club en van de configuratie van je betaaldienst. TWINT wordt bijvoorbeeld alleen aan clubs in Zwitserland aangeboden, en de creditcard alleen wanneer de bijbehorende betaaldienst actief is.

Verwar dit veld niet met het gelijknamige veld Beschikbare betaalmethoden in de hierboven beschreven Fast Finance Link-configuratie. Het veld in de Fast Finance Link stuurt de methoden binnen het Fast Finance Link-traject aan; dit veld stuurt aan wat je leden als terugkerende betaalmethode kunnen opslaan.

Zo gebruiken je leden de self-service

Zodra de configuratie klaar is, kunnen je leden hun betaalgegevens zelf beheren:

  • Member Platform (app): in het self-servicegedeelte van de app kunnen je leden hun betaalmethode toevoegen of bijwerken. De invoer verloopt via een beveiligde, versleutelde betaalcomponent.

  • Branded App: dezelfde functie is ook in je Branded App beschikbaar.

  • Member Web: je leden kunnen hun betaalgegevens ook via de Member Web bijwerken.

Belangrijk: creditcardgegevens die een lid via de app opslaat, kunnen door de club niet worden ingezien of beheerd. Alleen het lid heeft toegang tot deze informatie.

Bij betaalmethoden zoals de creditcard kan een aanvullende authenticatie nodig zijn (bijvoorbeeld 3D Secure). Het lid wordt dan doorgestuurd naar zijn bank en na afloop automatisch teruggeleid.

Integratie voor technische partners (Payment API)

Voor technische partners die de betaalcomponent in hun eigen applicatie willen integreren is de Payment API beschikbaar. De integratie verloopt in twee stappen:

Stap 1: de User Payment Session aanmaken. Via het endpoint POST /v1/payments/user-session wordt een kortlopend sessietoken gegenereerd. Dit token autoriseert de betaalcomponent in de frontend. De relevante parameters zijn:

  • amount: het betaalbedrag. Zet de waarde op 0 als er alleen een betaalmethode wordt opgeslagen.

  • scope: de betaalcontext. MEMBER_ACCOUNT voor terugkerende betalingen of ECOM voor e-commerce-aankopen.

  • customerId of finionPayCustomerId: de identificatie van de klant. Gebruik precies één van beide parameters.

  • permittedPaymentChoices: optionele beperking van de aangeboden betaalmethoden (bijvoorbeeld CREDIT_CARD of PAYPAL). Wordt deze parameter niet gezet, dan worden alle technisch beschikbare methoden aangeboden.

  • referenceText: de referentietekst die op het bankafschrift van het lid verschijnt.

Vereiste scope: PAYMENT_WRITE

Stap 2: de betaalcomponent (widget) inbedden. De betaalcomponent is een inbedbare JavaScript-widget. Je neemt het widgetscript op en initialiseert het met het ontvangen sessietoken:

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

<script>
const widget = window.paymentWidget.init({
    userSessionToken: 'your-session-token',
    environment: 'live',
    countryCode: 'NL',
    locale: 'nl-NL',
    container: 'payment-widget',
    onSuccess: (paymentRequestToken) => {
        // Token voor de verdere verwerking gebruiken
    }
});
</script>

De widget ondersteunt eigen aanpassingen via de parameters voor styling (kleuren, randen) en i18n (vertalingen). In de documentatie vind je integratievoorbeelden per framework (React, Angular, Vue.js).

Belangrijke opmerkingen over de tokenverwerking:

  • Het paymentRequestToken dat de widget teruggeeft, kun je gebruiken om een betaalmethode voor de klant op te slaan of om een betaling te starten.

  • Zolang het token niet voor een boeking wordt gebruikt, worden er geen bedragen afgeschreven. De autorisatie wordt automatisch geannuleerd wanneer het bijbehorende sessietoken verloopt.

  • Per User Payment Session kan slechts één token worden ingewisseld.

De volledige API-documentatie, inclusief endpoints en voorbeelden, vind je in het Developer Portal.

Let op: Dit artikel is met behulp van AI vertaald. Onze excuses voor eventuele fouten.

Verwante artikelen