De betaalflows zijn uitgebreider bij een Orafin-integratie.
PaymentRequest flow
Allereerst bent u verplicht in de paylink request een aantal aanvullende velden mee te sturen:
ipdcCode
customerType (“KSZ” of “KBO”)
insz (als KSZ)
kboNumber (als KBO)
Wij vragen deze extra informatie omdat Orafin moet weten voor welk product de betaling is (om de vordering correct te kunnen inboeken), en voor wie (voor eventuele terugvorderingen).
Zie ook https://api.betalingen.tni-vlaanderen.be/documentation/swagger-ui/index.html?configUrl=%2Fdocumentation%2Fswagger.json%2Fswagger-config&urls.primaryName=payment#/Betalingsverzoeken/pay => examples => voor klanten met een Orafin-integratie.
De gestructureerde mededeling
Daarnaast zullen wij een gestructureerde mededeling voor u genereren. Op die manier kunnen wij Orafin garanderen dat een vordering over alle entiteiten heen uniek geïdentificeerd kan worden.
De gestructureerde mededeling zit verdisconteerd in de paylink. Wanneer de betaling door de burger gedaan wordt, zal deze gestructureerde mededeling dus meegestuurd worden naar de bank.
de gestructureerde mededeling wordt dus op voorhand aangemaakt, ongeacht of de burger nu wel of niet betaalt.
Completion flow
De payment provider stuurt ons een bericht wanneer de betaling is voldaan. Wij markeren deze betaling langs onze kant als compleet, en zullen vervolgens om middernacht alle completed betalingen verzamelen en naar Orafin sturen. Orafin ontvangt dit bestand (en langs een ander kanaal ook de bankbestanden) en kan dan op basis van (onder andere) de gestructureerde mededeling de vorderingen inboeken.
De gestructureerde mededeling
De gestructureerde mededeling komt dus alleen voor geslaagde betalingen bij Orafin terecht. Om uniciteit te garanderen zal een gestructureerde mededeling van een “hangende” betaling nooit hergebruikt worden.
een gestructureerde mededeling betekent dus niet dat een betaling effectief is gedaan. U zult wel zien dat de gestructureerde mededelingen oplopen. Echter, omdat ook andere entiteiten van de sequentie voor gestructureerde mededelingen gebruik maken, zullen uw gestructureerde mededelingen vrijwel zeker niet een gesloten reeks vormen.