Zie ook:
Connectiviteitstest op TNI
De connectiviteitstest op TNI is de eerste stap in het testplan. Gebruik hiervoor het endpoint:
GET/api/v1/configuration/validate
Dit endpoint heeft geen parameters. Het controleert uw token op geldigheid en doet een eerste scan van uw configuratie.
Het onderstaande voorbeeld toont een situatie met een geldig token maar met een ontbrekende configuratie voor de organisatie en voor de tenant.
"authenticationStatus": "OK"
"organisationConfiguration": {
"status": "NOK"
},
"tenantConfiguration": {
"status": "NOK"
}
De configuratie is pas volledig in orde wanneer Digitaal Vlaanderen alle aansluitingsdocumentatie ontvangt (KYC-documenten). Zolang dit niet is gebeurd, zal deze test op minimaal één status “NOK” retourneren.
Neem in dit geval contact op met het team Aansluitingen om de configuraties in orde te brengen. Pas wanneer beide statussen “OK” zijn, kunt u verder met de integratietesten op TNI.
Integratietest op TNI
Via de integratietest gebruikt u de Betaalmodule als component in uw eigen functionaliteiten.
Uw TNI-account is gelinkt aan een demo-account bij POM. Hiermee kunt u alleen simulatiebetalingen doen. Er kan daarbij niets verkeerd lopen.
Breng het team Aansluitingen op de hoogte van uw eerste integratietest. Zij zorgen voor technische back-up.
Een integratietest verloopt doorgaans als volgt:
Stap | Handeling |
|---|---|
1 | Laat uw applicatie het endpoint POST Er is een verschil voor Orafin- en niet-Orafin-gebruikers. Zie: https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6269141061/Testplan+Betaalmodule#Orafin-gebruikers . U krijgt een paylink en het paymentId, waaronder het betaalverzoek bij Digitaal Vlaanderen bekend is. |
2 | Gebruik de paylink om een simulatiebetaling te doen. De simulatiebetaling zelf gebeurt buiten de Betaalmodule om en bevat alleen informatie over de online status van de betaling. Koos u een redirect en gaf u die redirect-URL mee in de body van de POST-call in stap 1, dan moet de browser redirecten naar die URL. De redirect-URL wordt aangevuld met de volgende parameters:
Koos u geen redirect, dan blijft de POM-pagina open op de succespagina. |
3 | U ontvangt de callback (optioneel) die de betaling al dan niet COMPLETED maakt. De Betaalmodule stuurt deze callback als u een callback endpoint heeft dat geconfigureerd is bij Digitaal Vlaanderen. Om veiligheidsredenen bevat de callback geen andere informatie. U haalt de andere informatie zelf op in de volgende stap . |
4 | U ontvangt de paymentId waaronder de betaling bij Digitaal Vlaanderen bekend is. |
5 | Haal de betaalstatus op via dit endpoint: GET Gebruik hiervoor de paymentId uit de callback. Gebruik u geen callbackmechanisme, neem dan de paymentId uit stap 2. |
6 | U ontvangt de status van de betaling als antwoord. |
7 | Test verder uw eigen use cases en de integraties met uw frontend. |
Integratietesten voor Orafin-gebruikers
Orafin genereert dagelijks een batchbestand dat Digitaal Vlaanderen alleen visueel kan nazien. Omdat we op TNI alleen werken met simulatiebetalingen, is er geen upload naar Orafin zelf. Zo een upload kan pas bij testen in productie.
Indien nodig, kunt u een apart testaccount laten opzetten via POM om echte betalingen te testen (zoals in https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6269141061/Testplan+Betaalmodule#Integratietest-in-productie . Neem hiervoor contact op met het team Aansluitingen en reken op een meerkost.
Connectiviteitstest in productie
Zodra uw applicatie voldoende is doorgetest kunt u naar productie gaan. De testcyclus start dan opnieuw op productie.
Volg dezelfde stappen als in de https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6269141061/Testplan+Betaalmodule#Connectiviteitstest-op-TNI , maar op de productieomgeving, met uw productietoken.
Integratietest in productie
Testen gebeurt vanaf hier met echte betalingen.
Orafin-gebruikers
Volg hier dezelfde stappen als voor https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6269141061/Testplan+Betaalmodule#Integratietest-op-TNI met een vrijwilliger die bereid is de aankoop te doen.
Aan het einde van de dag wordt het Orafin-bestand naar Orafin verstuurd ter verwerking. Digitaal Vlaanderen krijgt een resultaatbestand terug waarin staat of de verwerking al dan niet is gelukt. Is de betaling geen succes, dan is de configuratie niet in orde.
Geef dus zeker correcte informatie door bij de aansluiting, zoals bijv. de boekhoudsleutels.
Niet-Orafin-gebruikers
Volg hier dezelfde stappen als voor https://vlaamseoverheid.atlassian.net/wiki/spaces/IKPubliek/pages/6269141061/Testplan+Betaalmodule#Integratietest-op-TNI met een vrijwilliger die bereid is de aankoop te doen.
De connectiviteitstest in productie is optioneel voor niet-Orafin-gebruikers, maar we raden aan om deze test toch te doen voordat u uw productieomgeving openstelt voor eindgebruikers.
Vragen?
Met vragen over testen van de Betaalmodule kunt u altijd terecht bij het team Aansluitingen.