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. Gebruik 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.