Use the /Sessions/Initiate endpoint as the final step to ensure you can have a user complete the payments flow.

To successfully call this endpoint, you must first call the /Authorize endpoint to obtain a valid access token. You must also have already called the /Sessions/Initiate API and received a valid sessionId.

Creating a payment request

Now that you have successfully authorized and initiated a session, it's time to create a payment request and link your sessionId to a requestId. This request activates the previously created session and provides the user with the ability to complete the FlinksPay app flow by being redirected to their institution. It is imperative that you call this endpoint before launching the application for your user.

When creating a payment request using this endpoint, you are linking a sessionId to a requestId. This validates the session and creates the payment activity. It also enables you to use the given requestId to retrieve details on payment statuses.


Using sessionId in App without a valid request

If you do not create a payment request prior to launching the application with a generated sessionId, the user will not be able to complete the flow. Please ensure that you create a payment request prior to launching the application for the user.

To create a payment request, simply use the access_token as authorization, and supply the previously generated (from /Sessions/Initiate) sessionId within the body of the request.

In return, you will receive a HTTPS 200 OK and a requestId that can be used to track the users activity and the corresponding payment.

Once you receive a 200 OK and the associated requestId you are now able to initiate the application for your end-user and they will be able to complete the flow.

Please use the previously acquired sessionId to append to your base FlinkPay URL (provided at onboarding - for example https://{BaseURL}/app/?sessionId={{sessionId}} ) in order to generate the app session and have the user complete the flow.

Click Try It! to start a request and see the response here!