webapi/Purchase - Оплата по карте
Описание
- HTTP‑метод:
POST
- URL:
/webapi/Purchase/
- Форма взаимодействия: Клиент-сервер
- Формат тела запроса:
application/x-www-form-urlencoded (передается как форма для корректного перенаправления)
- Назначение: Регистрация операции с типом PURCHASE. Запрос выполняется с перенаправлением плательщика на платёжные страницы ПЦ.
URL
Структура запроса
| Поле |
Тип |
Обяз. |
Описание |
sector |
str |
✔ |
Уникальный идентификатор учётной записи ТСП в ПЦ. |
id |
int |
✔ |
Идентификатор заказа в ПЦ, полученный из webapi/Register. |
signature |
str |
✔ |
Цифровая подпись (sector, id, payer_id, pan_token_sha256, password) |
| Необязательные параметры |
cvc |
str |
|
CVC/CVV2/ППК2 код карты. |
get_token |
int |
|
Флаг запроса токена карты в уведомлении (0 — нет, 1 — да). |
token |
str |
|
Токен ранее зарегистрированной карты плательщика. |
action |
str |
|
Режим исполнения (pay — провести операцию без отображения платёжной формы, при нехватке данных форма будет показана). |
payer_id |
str |
|
Идентификатор клиента на стороне ТСП. |
pan_token |
str |
|
Значение для передачи номера карты, по которой будет проводиться операция. Если передано, пользователь не сможет указать другую карту. |
pan_token_sha256 |
str |
|
SHA‑256‑хеш значения pan_token, включаемый в подпись. |
pan |
str |
|
Полный номер карты плательщика. |
month |
int |
|
Месяц окончания срока действия карты. |
year |
int |
|
Год окончания срока действия карты. |
save_card |
int |
|
Признак сохранения карты. |
applePaymentData |
str(base64 JSON) |
|
Платёжные данные Apple Pay (base64 JSON). |
googleCryptogram |
str(base64 JSON) |
|
Платёжные данные Google Pay (base64 JSON). |
yandexCryptogram |
str(base64 JSON) |
|
Платёжные данные Yandex Pay (base64 JSON). |
samsungRefId |
str |
|
Идентификатор запроса криптограммы Samsung Pay. |
Структура ответа
Успешная обработка запроса проведет перенаправление пользователя на форму оплаты.
Примечания
Возможно небольшое отличие от описанного поведения при разных статусах обработки заказа.