...
Als dit allemaal in orde is, kan je verdergaan met de instructies op deze pagina om de betaalmodule te activeren op een formulier.
De betaling verloopt in volgende stappen:
de gebruiker “submit” het formulier
op de speciale dank u pagine komt er een knop om de betaling op te starten
Als je op de knop drukt opent er een scherm van POM
De gebruiker voert de betaling uit
De gebruiker wordt teruggestuurd naar de dank u pagina, en krijgt een aangepast tekst te zien.
Configureren van de betaalmodule op een formulier
...
Creëer een confirmatie pagina naast het formulier
Sleep de “Betaling” component op de confirmatie pagina en configureer deze
Open het formulier opnieuw en verwijs naar deze confirmatie pagina via de eigenschappen van de form container:
De “Betaling” component kent enkele statussen:
Initialised: Bij het openen van de confirmatie pagina en er kon een betaal link worden opgebouwd, zal de component in deze modus renderen. De gebruiker krijgt dan de betaal knop te zien. Door op de betaalknop te klikken, zal de component naar de “polling” status overgaan. Het betaalscherm zal openen in een nieuwe tab.
Initialize failure: Bij het openen van de confirmatie pagina en er kon GEEN betaal link worden opgebouwd, zal de component in deze modus renderen. De gebruiker kan naar geen enkele andere status meer en blijft deze tekst zien.
Polling: De component zal pollen naar de betaalmodule (local storage & API) om te kijken of de betaling in de andere tab al is afgerond.
Succes: Na polling kom je in deze status terecht als de gebruiker de betaling succesvol heeft afgerond.
Failure: Na polling kom je in deze status terecht als de gebruiker de betaling niet succesvol heeft afgerond. De betaalknop zal opnieuw renderen om de gebruiker opnieuw te laten proberen.
Voor elk van deze statussen kan een andere tekst worden beheerd om de gebruiker te informeren.
Testen & valideren van betaalmodule op een formulier
Enkele belangrijke velden:
Account / Client ID: als deze niet gekend is bij de betaalmodule, zal er een fout optreden bij het opbouwen van de betaallink
De account kan herbruikt worden in andere formulieren zolang de organisatie én IBAN dezelfde blijft.
IPDC code (enkel Orafin): als de Client ID geen toegang heeft tot deze IPDC code, zal er een fout optreden bij het opbouwen van de betaallink
Om dit te testen:
Zet alles op op de beheer omgeving (formulier en confirmatie pagina)
Vul het formulier zelf in en klik op verzenden
Als je ook de confirmatie pagina dit ziet, weet je of de betaling geslaagd is of niet:
Je ziet de knop “Betaalvenster openen” op de confirmatie pagina: betaallink kon worden opgevraagd
Klik op deze link om het betaal scherm te zien: Alles lijkt goed geconfigureerd te zijn
Je ziet een betaling foutmelding op de confirmatie pagina: betaallink kon NIET worden opgevraagd, kijk de configuratie naKies hiervoor bij de templates: “Danku pagina voor betalingen”
...
U kan de teksten bepalen die op deze pagina zullen verschijnen:
...
Panel initialised: de tekst die verschijnt na het indienen van de data, waarin gevraagd wordt aan de gebruiker om de betaling uit te voeren
Panel polling: de tekst die verschijnt terwijl er wordt gewacht op bevestiging van POM dat de betaling in orde is.
Panel success: de tekst die wordt getoond als de betaling met success is uitgevoerd
Panel failure: de tekst die wordt getoond als de betaling is mislukt. De gebruiker moet de betaling dan opnieuw opstarten.
Panel Initialise failure: tekst die wordt getoond als het aanmaken van een betaallink is gefaald (probleem met de betaalmodule). De betaling kan niet worden opgestart.
Panel met de knop die linkt naar het betaalvenster.
Betaalgegevens in de JSON ontvangen op het endpoint
...
Er bestaat ook een kans dat de gebruiker helemaal niks betaaldbetaalt.
In dit geval ontvangt de entiteit ontvang je dus wel een JSON, maar ze kunnen je kan er nooit vanuit gaan dat de betaling gebeurt gebeurd is. Elke entiteit moet dus zelf gaan controleren op of de betaling gebeurt gebeurd is, dit kan aan de hand van de transactie id. Deze kan ook als Meta data in de output JSON terecht komen.
De transaction ID is de ID om de status van de betaling om op te vragen. De entiteit is daarna zelf verantwoordelijk om de betaallink opnieuw bij de gebruiker te bezorgen.