Skip to main content
POST
Create payment consent

Sample cURL

Response Example

The magicLinkToken JWT contains an answer field with the authentication code needed for executing the prepared order. The consentId must be referenced when preparing and executing financial operations.

Headers

X-Tenant-ID
string
required
Example:

"tenant-demo-001"

X-User-ID
string
X-Forwarded-For
string
required

Client IP address

Example:

"127.0.0.1"

X-Forwarded-From
string
required

Client source identifier

Example:

"client-app"

platform
string
required

Client platform

Example:

"mobile"

deviceId
string
required

Device identifier

Example:

"device-demo-001"

Authorization
string
required

Bearer JWT

Example:

"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJkZW1vLXVzZXIifQ.demo-signature"

Path Parameters

accountId
string<uuid>
required
Example:

"00000000-0000-0000-0000-000000000000"

operationType
enum<string>
required

Operation kind for payment consent (aligned with wallet operation types)

Available options:
TRANSFER,
TOPUP,
EXTERNAL,
INTERNAL,
EXCHANGE,
WITHDRAW,
PAYMENT
Example:

"TRANSFER"

Body

application/json

Payment consent payload

Create payment consent request

maxAmount
object

Maximum amount configuration

Example:
allowedBeneficiaries
string[]

Allowed beneficiary identifiers

Example:
validFrom
string

Consent validity start date (YYYY-MM-DD)

Example:

"2026-03-26T00:00:00.000Z"

validUntil
string

Consent validity end date (YYYY-MM-DD)

Example:

"2027-03-26T00:00:00.000Z"

description
string

Human-readable consent description

Example:

"Transfer processing consent for organization payments"

title
string

Consent title

Example:

"Business Payment Consent"

paymentType
string

Payment type

Example:

"TRANSFER"

parameters
object

Advanced consent parameters

Response

Payment consent created

Standard API response wrapper with payment consent in data

code
integer<int32>

HTTP-style status code

Example:

201

data
object

Payment consent

message
string

Result message

Example:

"Success"