Create a new AoF consent

post

https://sandbox.leantech.me/consents/v1/account-on-file

Creates a new Account-on-File consent that can be authorized later.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request to create a new Account on File consent

customer_id

uuid

required

The unique identifier of the customer for whom the consent is being created.

destination_account_id

uuid

required

The unique identifier of the account acting as a consent beneficiary.

currency

string

required

The ISO 3 letter currency code.

reference

string

required

length ≤ 64

A reason or reference in relation to a payment. Maximum 64 chars

purpose

string

enum

required

A category code that relates to the type of services or goods that corresponds to the underlying purpose of the payment.
The code must conform to the payment purpose code list.
Supported values:

FIS – Financial services
TCS – Telecommunication services
MWP – Mobile wallet card payments
OAT – Own account transfer
IFS – Information services
RNT – Rent payments
LNC – Loan charges
PIN – Personal investments
GDS – Goods bought or sold

control_parameters

required

government_identifier

object

Unique government identifier of the customer making the payment.
As required by the UAE Open Finance standard, it ensures the debtor can be uniquely recognized. This field supports providing or updating the identifier on-the-fly when creating a consent.

start_date_time

date-time | null

The date and time when the consent becomes active.
Optional. Defaults to the current date and time if not provided.

expiration_date_time

date-time | null

The date and time when the consent expires.
Optional. Defaults to one year after start_date_time if not provided.

immediate_payment

object | null

Details of a payment that will be executed immediately after the user successfully authorizes the consent. If present, the payment is initiated automatically as part of the consent authorization flow.

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Consent created successfully