Create a Request To Pay

This endpoint allows creation of a request to pay by providing the merchant with a Fintecture payment link. Link can either be sent by email or SMS or returned directly in the response.

The same endpoint can be used for Immediate Transfer, Smart Transfer and Buy Now Pay Later. Mixing them is also possible, see the Fintecture Payment Hub guide to know more about it.

🚧 Important

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

Query Params
string

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

string

an optional state parameter which will be provided back on redirection

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
meta
object
required

Request meta to configure some settings of the payment (expiry, payment_methods, PSU info...)

data
object
required
Headers
string
required

Sha-256 base64 encoded digest.
Related documentation can be found by clicking here

string
required

Signature is used to enforce security by signing request.
Related documentation can be found by clicking here

string
required

RFC2822 formatted date.

string
required

uuid v4. Required in Redirect mode.

string
enum

Type of PSU

Allowed:
string
length between 2 and 2

2 letter country code

string
length between 2 and 2

A 2 letter language code to set the preferred language for PSU notifications.
Default value: en

string

provider_id

Responses

Language
Credentials
OAuth2
URL
Response
Choose an example:
application/json