Payment Mandate (Платёжный мандат)¶
Payment Mandate — это мандат, используемый для авторизации платежа по конкретному заказу (checkout).
Назначение¶
Содержимое Payment Mandate создаётся Торговым Агентом (Shopping Agent), отображается Пользователю на Доверенной Поверхности (Trusted Surface) и верифицируется Провайдером Удостоверений (Credential Provider), Платёжной Сетью (Network) и Платёжным Процессором Продавца (Merchant Payment Processor).
Тип¶
- Закрытый Payment Mandate:
vct = "mandate.payment.1" - Открытый Payment Mandate:
vct = "mandate.payment.open.1"
Версионирование: см. раздел «Версионирование мандатов» в спецификации AP2.
Схема мандата (закрытый)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
vct |
string | Да | Должен быть mandate.payment |
transaction_id |
string | Да | base64url-хеш поля checkout_jwt, связывающий платёж с корзиной |
payee |
Merchant | Да | Получатель платежа (продавец) |
pisp |
Pisp | Нет | Провайдер инициирования платежа (PISP) |
payment_amount |
Amount | Да | Сумма (amount в минорных единицах + currency по ISO 4217) |
payment_instrument |
PaymentInstrument | Да | Используемый платёжный инструмент |
execution_date |
string | Нет | Дата исполнения в формате ISO 8601 |
risk_data |
object | Нет | Сигналы риска, собранные доверенной поверхностью |
iat |
integer | Нет | Unix-время создания |
exp |
integer | Нет | Unix-время истечения |
Открытый Payment Mandate МОЖЕТ опционально включать любое свойство из закрытого.
Ограничения (Constraints) платёжного мандата¶
Периодичность агента (payment.agent_recurrence)¶
Определяет условия для многократного использования мандата агентом.
Свойства:
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
type |
string | Да | "payment.agent_recurrence" |
frequency |
string | Да | ON_DEMAND, DAILY, WEEKLY, BIWEEKLY, MONTHLY, QUARTERLY, ANNUALLY |
max_occurrences |
integer | Нет | Максимальное количество повторений |
Допустимые получатели (payment.allowed_payees)¶
Ограничивает список возможных получателей платежа.
Допустимые платёжные инструменты (payment.allowed_payment_instruments)¶
Ограничивает набор допустимых платёжных инструментов по id, type и description.
Допустимые PISP (payment.allowed_pisps)¶
Определяет набор провайдеров инициирования платежа (Payment Initiation Service Providers), авторизованных для проведения транзакции.
Диапазон суммы (payment.amount_range)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
type |
string | Да | "payment.amount_range" |
currency |
string | Да | Трёхбуквенный код валюты по ISO 4217 |
max |
integer | Да | Максимальная сумма в минорных единицах |
min |
integer | Нет | Минимальная сумма (при отсутствии — без ограничения) |
Бюджет (payment.budget)¶
Определяет максимальную общую сумму при использовании с ограничением
payment.agent_recurrence. Накопительный: сумма каждого нового закрытого мандата
прибавляется к общей сумме уже совершённых платежей.
Привязка к корзине (payment.reference)¶
Связывает данный Payment Mandate с конкретным Checkout Mandate через
conditional_transaction_id — дайджест связанного открытого Checkout Mandate.
Дата исполнения (payment.execution_date)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
type |
string | Да | "payment.execution_date" |
not_before |
string | Нет | Самая ранняя допустимая дата исполнения |
not_after |
string | Нет | Самая поздняя допустимая дата исполнения |
Payment Receipt (Платёжная квитанция)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
status |
ReceiptStatus | Да | Success или Error |
iss |
string | Да | Эмитент квитанции |
iat |
integer | Да | Unix-время создания |
reference |
string | Да | Хеш закрытого мандата |
error |
string | Нет | Код ошибки |
error_description |
string | Нет | Человекочитаемое описание ошибки |
payment_id |
string | Да | Уникальный идентификатор платежа |
psp_confirmation_id |
string | Нет | Идентификатор подтверждения на стороне PSP |
network_confirmation_id |
string | Нет | Идентификатор подтверждения на стороне сети |
Общие типы данных¶
Amount (Сумма)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
amount |
integer | Да | Сумма в минорных единицах согласно ISO 4217 |
currency |
string | Да | Трёхбуквенный код валюты по ISO 4217 |
Merchant (Продавец)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
id |
string | Да | Уникальный идентификатор |
name |
string | Да | Человекочитаемое название |
website |
string | Нет | Веб-сайт |
PaymentInstrument (Платёжный инструмент)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
id |
string | Да | Уникальный идентификатор инструмента |
type |
string | Да | Категория инструмента (card, UPI и т. д.) |
description |
string | Нет | Описание для отображения пользователю |
Pisp (Провайдер инициирования платежа)¶
| Атрибут | Тип | Обязательный | Описание |
|---|---|---|---|
legal_name |
string | Да | Юридическое название |
brand_name |
string | Да | Торговое название |
domain_name |
string | Да | Доменное имя, подтверждённое QWAC-сертификатом eIDAS |