Create a Payment Session

post

https://api.sandbox.fintecture.com/pis/v2/connect

This endpoint aims at providing a payment session for a PSU to initiate a payment.

The same endpoint can be used to generate an Immediate Transfer, a Smart Transfer or a Buy Now Pay Later payment. To mix Immediate Transfer, Smart Transfer and Buy Now Pay Later in the same payment session, see the Fintecture Payment Hub guide

🚧 Important
Signature, digest, date and x-request-id headers are mandatory when calling the PRODUCTION environment

💡 Note
Request payloads examples for Immediate Transfer, Smart Transfer and Buy Now Pay Later can be found under the "Example" dropdown.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

state

string

required

length ≤ 512

a state parameter which will be provided back on redirection

redirect_uri

string

https:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_\+.~#?&//=]*)

must correspond to one of the URLs provided when creating an application on the console. Required in Redirect mode.

origin_uri

string

The URL to which he will be returned if he cancels the payment from the Connect webview. By default the user is returned to the previous screen (i.e. your checkout page)

with_beneficiary

boolean

Returns the beneficiary in the response

with_virtualbeneficiary

boolean

Returns the virtual beneficiary in the response. Requires an internal payment account to be enabled.
⚠️ This query param should only be added for Smart Transfer payments as the virtual beneficiary is only available for those payments.

Body Params

PIS Connect request

200successful operation

400bad request

401unauthorized

403forbidden

500internal server error