In dit artikel leer je hoe je per lidmaatschapsofferte kunt definiëren welke kosten direct bij aanmelding via de Open API moeten worden geïnd, wat er gebeurt als een betaling mislukt, hoe dit de toegang van je leden beïnvloedt en hoe leden op studiopagina's zelf hun startdatum kiezen.
Inhoud
- Wat is de initiële betaling?
- Configuratie in de lidmaatschapsofferte
- Welke kosten maken deel uit van de initiële betaling?
- De betaling verplicht stellen voor Open API-aanmeldingen
- Wat gebeurt er als een betaling mislukt?
- Hoe het betalingsproces werkt
- Speciale situatie: lidmaatschapswissel
- Toegangsbeperking voor openstaande initiële betalingen
- Startdatum zelf kiezen op studiopagina's
Snelgids
Vind je een gebied niet in de zijbalk links, klik daar op het laatste item, Meer. Gebruik Navigatie aanpassen om te kiezen welke gebieden direct in de zijbalk staan.
- Instellingen / Contractsluiting / Contractaanbiedingen
- Open de relevante lidmaatschapsofferte
- Ga naar de sectie Offerte-opties
- Selecteer de kostentypen die de initiële betaling vormen
- Optioneel: activeer Vereis initiële betaling voor Open API-aanmeldingen
- Optioneel: activeer Annuleer contractaanmaak bij mislukte inning van initiële betaling
- Opslaan
Wat is de initiële betaling?
Wanneer een contract wordt ondertekend via de Open API, kan je API-partner aanmeldkosten direct innen als onderdeel van het aanmeldproces. Je bepaalt per lidmaatschapsofferte welke kostentypen als initiële betaling gelden, of die betaling verplicht is en wat er gebeurt als de inning mislukt. Deze instellingen beïnvloeden ook direct de toegang voor leden die met openstaande betalingen zijn geregistreerd.
Configuratie in de lidmaatschapsofferte
Alle instellingen voor de initiële betaling bevinden zich in de sectie Offerte-opties van de relevante lidmaatschapsofferte onder Instellingen / Contractsluiting / Contractaanbiedingen. Open de offerte die je wilt configureren. De drie nieuwe velden verschijnen onderaan de sectie. Bestaande lidmaatschapsoffertes worden automatisch gemigreerd met de hieronder beschreven standaardwaarden. Je huidige processen worden hierdoor niet beïnvloed.
Welke kosten maken deel uit van de initiële betaling?
In het veld Initiële betaling omvat (indien verschuldigd bij aanmelding) gebruik je een meerkeuzeveld om te definiëren welke kostentypen als initiële betaling gelden. De beschikbare opties zijn: contributie, startpakket, aanvullende modules en vaste kosten. Standaard zijn alle vier opties geselecteerd.
Belangrijk: alleen kosten die daadwerkelijk verschuldigd zijn op het moment van contractsluiting worden meegenomen. Toekomstige kosten maken geen deel uit van de initiële betaling. Deze definitie geldt niet alleen voor Open API-aanmeldingen, maar vormt ook de basis voor toegangsbeperkingen via alle andere contractkanalen.
De betaling verplicht stellen voor Open API-aanmeldingen
De optie Vereis initiële betaling voor Open API-aanmeldingen is standaard inactief. Wanneer je deze activeert, moet je API-partner bij het aanmaken van het contract een geldig betaaltoken aanleveren. Het systeem controleert automatisch of het geautoriseerde bedrag precies overeenkomt met het totaal van alle verschuldigde kosten. Als de bedragen niet overeenkomen, wordt de aanmelding afgebroken en wordt er geen contract aangemaakt.
Als de optie inactief is, kan er bij aanmelding geen betaaltoken worden meegegeven. Een initiële betaling is dan via dit kanaal niet mogelijk.
Je kunt deze optie gefaseerd activeren: definieer eerst de kostentypen, schakel daarna de vereiste in zodra je operationeel klaar bent. Beide stappen zijn onafhankelijk van elkaar.
Wat gebeurt er als een betaling mislukt?
De optie Annuleer contractaanmaak bij mislukte inning van initiële betaling is standaard inactief. Deze treedt in werking wanneer de daadwerkelijke betaling mislukt nadat de aanmelding is ingediend.
- Optie actief: Het systeem maakt de contractaanmaak ongedaan. Het contract wordt verwijderd. Het klantrecord blijft behouden. Toegang wordt beperkt totdat een nieuwe aanmelding succesvol is afgerond.
- Optie inactief (standaard): Het contract blijft bestaan. Het openstaande bedrag wordt geregistreerd op het ledenaccount en kan via je gebruikelijke processen worden geïnd, bijvoorbeeld via een betaalrun of een herinnering.
Hoe het betalingsproces werkt
Om te begrijpen wanneer een mislukking kan optreden, werkt het proces als volgt: wanneer een lid zich aanmeldt via de Open API, autoriseert hij de betaling vooraf via de betaalinterface van je partner. Deze autorisatie blokkeert het bedrag, maar int het nog niet. De daadwerkelijke inning vindt plaats zodra het contract en de bijbehorende kosten in het systeem zijn geboekt. Op dat moment kan een mislukking optreden, bijvoorbeeld als de kaart is geblokkeerd of de autorisatie inmiddels is verlopen. Als het betaaltoken niet binnen de geldigheidsduur wordt gebruikt, wordt de autorisatie automatisch vrijgegeven en worden de middelen ontgrendeld.
Voor API-partners: de preview-endpoint retourneert de vlag mandatoryOnSigning voor elke verschuldigde kost, evenals het totaal van alle verplichte kosten in het veld dueOnSigningAmount. Het betaaltoken moet alleen worden opgevraagd en meegegeven op basis van dit exacte bedrag.
Speciale situatie: lidmaatschapswissel
Voor lidmaatschapswissels via de Open API gelden dezelfde instellingen als voor initiële aanmeldingen. Er is één uitzondering: als de lidmaatschapsofferte de optie heeft om initiële kosten bij aanvang van het lidmaatschap over te slaan, worden alle kosten behandeld alsof ze niet verschuldigd zijn op het moment van de wissel. In dit geval retourneert de preview-endpoint mandatoryOnSigning: false voor alle kosten en is het totaal verschuldigde bedrag nul. De switch-endpoint accepteert in dit scenario geen betaaltoken.
Toegangsbeperking voor openstaande initiële betalingen
Als de toegangsbeperkingsconfiguratie van je studio de optie heeft geactiveerd om toegang te beperken bij onbetaalde initiële betalingen, gelden de volgende scenario's:
- Betaling was geautoriseerd maar inning mislukt later, geen rollback: Het contract blijft bestaan. De toegang van het lid wordt beperkt totdat het openstaande bedrag is voldaan.
- Betaling was niet verplicht bij aanmelding: De toegang van het lid wordt beperkt totdat de initiële betaling achteraf is voldaan.
- Betaling mislukt en rollback is actief: Er bestaat geen contract. Het klantrecord blijft bestaan, maar zonder actief lidmaatschap is toegang niet mogelijk.
- Aanmeldingen via andere kanalen zoals het sales support gebied, het Ledenplatform of landingspagina's: ook deze contracten zijn onderhevig aan toegangsbeperking als de initiële betaling is gedefinieerd in de lidmaatschapsofferte en nog niet is voldaan. Toegang wordt pas verleend zodra alle gedefinieerde kostentypen zijn vereffend op het ledenaccount.
Startdatum zelf kiezen op studiopagina's
Beschikbaar vanaf 7 oktober 2026.
Op je studiopagina's kun je nieuwe leden bij de online aanmelding zelf de startdatum van hun lidmaatschap laten kiezen. Dit is geen instelling van de Open API: je activeert de functie per studiopagina en bepaalt zo op welke pagina's de datumkeuze wordt aangeboden.
- Open Instellingen / Online studiopagina's / Studio pagina's en kies de studiopagina.
- Bewerk de sectie Tarieven. Het dialoogvenster Configuratie bewerken wordt geopend.
- Activeer Leden de mogelijkheid bieden om de ingangsdatum van hun lidmaatschap te kiezen en sla op.
De afbeelding toont de Engelse interface: sectie Tarieven van een studiopagina met de status van de optie waarmee leden hun startdatum kiezen.
De afbeelding toont de Engelse interface: dialoogvenster Configuratie bewerken met het selectievakje waarmee leden hun startdatum kunnen kiezen.
Bij de aanmelding op deze studiopagina zien leden dan een extra stap waarin ze de startdatum kiezen:
- Het datumveld is vooraf ingevuld met de vroegst mogelijke startdatum van de lidmaatschapsofferte. Bij offertes die starten bij het afsluiten van het contract is dat vandaag.
- Leden kunnen een latere datum kiezen, tot 365 dagen na de vroegst mogelijke startdatum. Eerdere datums worden niet geaccepteerd.
- Is in de lidmaatschapsofferte bij Contractstart de optie Vaste datum ingesteld, dan wordt de datumkeuze niet getoond en geldt de vaste datum. Leden kunnen die niet wijzigen.
Hoe de startdatum van het contract en de startdatum van het gebruik samenhangen, lees je in het artikel Precontractueel gebruik, bonusperiodes en zelf gekozen startdatum.
Let op: Dit artikel is met behulp van AI gemaakt en automatisch vertaald zonder redactionele controle. Onze excuses voor eventuele fouten.