Voorbeelden van use cases
Digitale factuurpagina's verbeteren met Twikey
In veel factureringsflows wordt er waarschijnlijk al gewerkt binnen een bestaand factureringsframework. Dit kan een bestaande factuurdetailpagina, klantportaal of ERP-gestuurde factureringservaring omvatten waarmee klanten al vertrouwd zijn. In dergelijke scenario's introduceert het toevoegen van een aparte, volledige betaalpagina alleen voor extra betaalmethoden onnodige complexiteit, zowel technisch als vanuit gebruikservaring.
Twikey is ontworpen om naadloos te integreren in deze bestaande flows. In plaats van een volledige vervanging van de huidige factuurlandingspagina af te dwingen, maakt Twikey het mogelijk om individuele betaalmogelijkheden op aanvraag in te bedden en te orchestreren. Hierdoor kan de huidige factuurervaring worden uitgebreid met ondersteuning voor automatische betalingen (zoals domiciliering of terugkerende kaartbetalingen) en eenmalige transacties, terwijl de klant zoveel mogelijk binnen de eigen interface blijft.
De onderstaande secties beschrijven een veelvoorkomende use case waarbij een klant een factuur ontvangt, een bestaande factuurpagina bezoekt en de optie krijgt om automatische betalingen te activeren via Twikey of een eenmalige betaling uit te voeren. De sequentiediagrammen illustreren hoe deze interactie wordt weerspiegeld op API-niveau.
De automatische betaling
Wanneer een klant besluit om automatische betalingen in te schakelen, hetzij via domiciliering of terugkerende creditcard, moet een nieuwe overeenkomst worden aangemaakt in Twikey. Het aanvragen van de creatie van deze overeenkomst genereert een onderteken-URL, waarnaar de klant kan worden doorverwezen vanuit de factuurpagina of het klantportaal. De klant voltooit het ondertekeningsproces via de gehoste ondertekenmechanismen van Twikey, die zijn afgestemd op de geselecteerde betaalmethode en voldoen aan het toepasselijke betalingsschema en de regelgevende vereisten.
Na afronding van de ondertekeningsflow verwijst Twikey de klant terug naar een return-URL die het resultaat van de ondertekening weergeeft. Hierdoor kan de klant worden teruggeleid naar een bevestigingspagina, de oorspronkelijke factuurweergave of een algemeen accountoverzicht. Een webhook informeert het systeem wanneer de ondertekening is voltooid, zodat de factuurstatus dienovereenkomstig kan worden bijgewerkt.
Zodra een overeenkomst succesvol is ondertekend, kan deze worden gebruikt om openstaande of toekomstige facturen voor die klant te innen. Het systeem behoudt de controle over welke facturen in aanmerking komen voor incasso en wanneer deze moeten worden geind. Alles wat nodig is om de incasso te starten, is het overeenkomst-ID, het bedrag en het bericht aan de klant.
Als een betaling mislukt of wordt geweigerd, zet Twikey automatisch het incassoproces voort volgens het aanmaningsschema, dat kan worden geconfigureerd in het Twikey-dashboard. Gedurende dit proces wordt de huidige status van de transactie beschikbaar gesteld via de transactiefeed, waardoor systemen gesynchroniseerd blijven.
De eenmalige betaling
Naast automatische betalingen kunnen ook directe, eenmalige betalingen worden ondersteund door een betaallink te genereren via Twikey. Hierdoor kunnen klanten een factuur direct afrekenen zonder een overeenkomst aan te maken, terwijl de integratie ontkoppeld blijft van de onderliggende PSP en PSP-wijzigingen zonder impact op de API of bedrijfsflow mogelijk zijn.
Vanuit implementatieperspectief vraagt het systeem een betaallink aan via de Twikey API en verwijst de klant door naar de gehoste betaalpagina. Zodra de betaling is voltooid, geannuleerd of mislukt, verwijst Twikey de klant terug naar een return-URL die wordt beheerd, zoals een bevestigingspagina, de oorspronkelijke factuurweergave of een algemeen accountoverzicht, op basis van het resultaat. Een webhook informeert het systeem over het betalingsresultaat, zodat de factuurstatus in realtime kan worden bijgewerkt.
Bekijk het volledige sequentiediagram
Meer use cases
Aanvullende use cases worden momenteel ontwikkeld. In de tussentijd behandelt de API-referentie alle beschikbare endpoints, en de handleidingen bespreken elk productgebied in detail.