sector |
str |
✔ |
Уникальный идентификатор учетной записи ТСП в ПЦ. |
signature |
str |
✔ |
Цифровая подпись. В формировании подписи участвуют параметры (если они использованы в запросе): sector, id, payer_id, token, amount, currency, sd_ref, unique_key, password — в указанном порядке. |
| Условно‑обязательные параметры |
amount |
int |
|
Сумма операции в минимальных единицах валюты (для RUB — копейки). Используется, если не указан id. Если id указан — значение берётся из заказа. |
description |
str |
|
Описание перевода. Используется, если не указан id. Если id указан — значение берётся из заказа. |
currency |
int |
|
Код валюты по ISO4217 (643 — RUB; 978 — EUR; 840 — USD). Используется, если не указан id. Если id указан — значение берётся из заказа. |
| Необязательные параметры |
id |
int |
|
Уникальный идентификатор предварительно зарегистрированного заказа в ПЦ (полученный из webapi/Register). Если id задан, статус заказа должен быть REGISTERED. |
sd_ref |
str |
|
Уникальный идентификатор Кубышки. |
unique_key |
str |
|
Ключ уникальности запроса. При получении ключа ПЦ проверяет наличие дубля среди обрабатываемых запросов и созданных операций. Формат: допустимы цифры [0-9], латинские буквы [a-zA-Z], дефис и нижнее подчёркивание [-_]. Использование — по согласованию с Оператором. |
tips |
int |
|
Сумма чаевых в минимальных единицах валюты. Не может превышать amount. |
token |
str |
|
Токен ранее зарегистрированной карты Плательщика (для повторных операций без ввода реквизитов карты). Если token указан, параметр payer_id не используется. |
token2 |
str |
|
Токен карты получателя чаевых. |
payer_id |
str |
|
Идентификатор пользователя Площадки, для которого будет запомнена карта плательщика. |
client_ref |
str |
|
Идентификатор пользователя — получателя чаевых. |
get_token |
int |
|
Запрос на предоставление токена карты, использованной в операции, в составе уведомления на url. Возможные значения: 0 (по умолчанию) — не возвращать; 1 — вернуть токен. |
cvc |
str |
|
Проверочный код карты Плательщика CVV2/CVC2/ППК2. |
fee |
int |
|
Комиссия для удержания с Плательщика при списании средств с его карты в минимальных единицах валюты (для RUB — копейки). |
action |
str |
|
Если action=pay, ПЦ пытается провести операцию на основании параметров запроса без отображения платёжной формы. При нехватке данных отображается форма для заполнения. |
reference |
str |
|
Номер перевода на стороне ТСП (в ИС ТСП). |
url |
str |
|
URL на стороне ТСП для redirect после завершения операции. |
failurl |
str |
|
URL на стороне ТСП для redirect при неуспешном завершении операции (статус отличен от APPROVED или операция не сформирована). |
applePaymentData |
str (base64) |
|
Платёжные данные Apple Pay в виде base64‑кодированной строки JSON. Значение параметра paymentData из платёжного токена Apple Pay. Имеет более высокий приоритет над applePaymentToken. Анализируется только вместе с action=pay. |
applePaymentToken |
str |
|
Платёжный токен Apple Pay (объект PKPaymentToken). Анализируется только вместе с action=pay. |
googleCryptogram |
str (base64) |
|
Платёжные данные Google Pay в виде base64‑кодированной строки JSON (поле cryptogram). Анализируется только вместе с action=pay. |
yandexCryptogram |
str (base64) |
|
Платёжные данные Yandex Pay в виде base64‑кодированной строки JSON (поле cryptogram). Анализируется только вместе с action=pay. |
samsung_ref_id |
str |
|
Платёжные данные Samsung Pay: уникальный референс запроса на получение криптограммы карты. Анализируется только вместе с action=pay. |