In dit artikel leert u hoe u 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 en hoe dit de toegang van uw leden beïnvloedt.
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
Snelle route
- Instellingen / Lidmaatschap ondertekenen / Lidmaatschapsoffertes
- 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 uw API-partner aanmeldkosten direct innen als onderdeel van het aanmeldproces. U 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 / Lidmaatschap ondertekenen / Lidmaatschapsoffertes. Open de offerte die u wilt configureren. De drie nieuwe velden verschijnen onderaan de sectie. Bestaande lidmaatschapsoffertes worden automatisch gemigreerd met de hieronder beschreven standaardwaarden. Uw 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) gebruikt u 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 u deze activeert, moet uw 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.
U kunt deze optie gefaseerd activeren: definieer eerst de kostentypen, schakel daarna de vereiste in zodra u 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 uw 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 uw 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 uw 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.