Connectiviteitstest op TNI

De connectiviteitstest op TNI is de eerste stap in het testplan. Gebruik hiervoor het endpoint:
GET/api/v1/configuration/validate

Zie ook: https://api.betalingen.tni-vlaanderen.be/documentation/swagger-ui/index.html?configUrl=%2Fdocumentation%2Fswagger.json%2Fswagger-config&urls.primaryName=payment#/Onboarding/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 beide statussen op OK staan en alle aansluitingsdocumentatie in orde is. Zolang dit niet is gebeurd, zal deze test op minimaal één status “NOK” retourneren.

Neem in dit geval contact op met de projectverantwoordelijke bij Digitaal Vlaanderen 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 uw projectverantwoordelijke bij Digitaal Vlaanderen op de hoogte van uw eerste integratietest.

Een integratietest verloopt doorgaans als volgt:

Stap	Handeling

Stap	Handeling
1	Laat uw applicatie het endpoint POST `/api/v1/payments/pay` aanroepen met een geldige body. (Zie ook: https://api.betalingen.tni-vlaanderen.be/documentation/swagger-ui/index.html?configUrl=%2Fdocumentation%2Fswagger.json%2Fswagger-config&urls.primaryName=payment#/Onboarding/validate) U krijgt een paylink en het paymentId, waaronder het betaalverzoek bij Digitaal Vlaanderen bekend is.
2	Gebruik de paylink om een simulatiebetaling te doen. Koos u in het aansluitingsformulier 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: onlineStatus: de online status van de betaling pspResponseCode: de response code van de payment provider pspPaymentId: het id waaronder de betaling bekend is bij de payment provider 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 URL-endpoint heeft dat geconfigureerd is bij Digitaal Vlaanderen.
4	U ontvangt de paymentId waaronder de betaling bij Digitaal Vlaanderen bekend is.
5	Haal de betaalstatus op via dit endpoint: GET `/api/v1/payments/pay/{paymentId}/status` (Zie ook: https://api.betalingen.tni-vlaanderen.be/documentation/swagger-ui/index.html?configUrl=%2Fdocumentation%2Fswagger.json%2Fswagger-config&urls.primaryName=payment#/Onboarding/validate ) Gebruik hiervoor de paymentId uit de callback. Gebruikt 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 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 Testplan Betaalmodule | Connectiviteitstest op TNI , maar op de productieomgeving, met uw productietoken.

Integratietest in productie

Orafin-gebruikers

Volg hier dezelfde stappen als voor 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.

Niet-Orafin-gebruikers

Volg hier dezelfde stappen als voor Testplan Betaalmodule | Integratietest op TNI met een vrijwilliger die bereid is de aankoop te doen.

Vragen?

Met vragen over testen van de Betaalmodule kunt u altijd terecht bij het team Aansluitingen.

Documentatie voor partners en klanten van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers

Documentatie voor klanten en partners van Digitaal Vlaanderen - bouwstenen Mijn Burgerprofiel, Verenigingsloket en e-loketondernemers

Testplan Betaalmodule