Pay — рекуррентные платежи
https://{Environment}.payture.com/vwapi/PayКоманда для выполнения платежа по ранее привязанной карте без участия Покупателя (рекуррентный платеж) или для проведения оплаты в один клик без повторного ввода реквизитов карты (рекарринговый платеж). Карта должна находится в статусе «IsActive».
Для оплаты не требуется передача CVV2/CVC2 и прохождение аутентификации 3-D Secure.
Рекуррентные и рекарринговые платежи могут выполняться как при варианте интеграции «На стороне Продавца», так и «На стороне Payture».
Запрос
curl https://sandbox3.payture.com/vwapi/Pay \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=VWMerchantside \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
CardId=00a94d92-1d84-44be-fa32-1c9591443347; \
OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea; \
Amount=12480; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \В запросах наименования параметров чувствительны к регистру
| Параметр | Описание | Формат |
|---|---|---|
| VWID | Наименование платежного Терминала для выполнения рекуррентных / рекарринговых платежей | String Mandatory |
| DATA | Параметры платежа Url Encoded строка, содержащая пары ключей и их значений, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) | String Mandatory |
Состав ключей параметра DATA
| Параметр | Описание | Формат |
|---|---|---|
| VWUserLgn | Идентификатор Покупателя в системе Payture | String [1..50] Mandatory |
| VWUserPsw | Дополнительный параметр доступа к приватной информации Покупателя (пароль Покупателя) | String [1..50] Mandatory |
| CardId | Идентификатор ранее зарегистрированной карты в системе Payture | String [36] Mandatory |
| OrderId | Уникальный идентификатор платежа в системе Продавца Рекомендуемый формат: GUID/UUID или Alphanumeric. Другие форматы могут вызвать сбои в работе банковских сервисов. | String [1..50] Mandatory |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Цифры, не содержащие десятичных или других разделителей | Integer Mandatory |
| SessionType | Тип платежа. Определяет количество стадий платежа:Pay — одностадийный платеж (по умолчанию)Block — двухстадийный платеж | String Optional |
| IP | IP адрес Покупателя IPv4 или IPv6 | String Optional |
| Cheque | Информация о чеке в формате JSON, закодированная в Base64 | String Optional |
| Дополнительные параметры | Любые дополнительные параметры Продавца Дополнительных параметров может быть несколько. Каждый параметр передается отдельно | — Optional |
Пример параметра DATA (decoded):
VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=00a94d92-1d84-44be-fa32-1c9591443347;
OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea;
Amount=12480;
SessionType=Block;
AdditionalField1=Value1;
AdditionalField2=Value2Ответ
XML строка с элементом Pay
Примеры ответов
<Pay VWUserLgn="123@ya.ru" OrderId="5f63838d-fb03-00c6-c890-c67cfc1c54ea" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="True" Amount="12480"/>| Параметр | Описание | Формат |
|---|---|---|
| Success | Признак успешности операции. Принимает значения:True — операция успешнаFalse — операция неуспешна3DS — необходима аутентификация 3‑D Secure. Аутентификация может потребоваться для рекарринговых платежей в зависимости от конфигурации Терминала. Для рекуррентных платежей значение 3DS не возвращается | String Mandatory |
| VWUserLgn | Идентификатор Покупателя в системе Payture Соответствует переданному в запросе | String [1..50] Mandatory |
| OrderId | Идентификатор платежа в системе Продавца Соответствует переданному в запросе | String [1..50] Mandatory |
| MerchantOrderId | Идентификатор платежа в системе Payture Дополнительный идентификатор платежа, присвоенный системой Payture. Содержит номер попытки совершения платежа | String [1..50] Mandatory |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Передается, если «Success=True» или «Success=3DS». Соответствует переданному в запросе | Integer Optional |
| AddInfo | Дополнительные параметры транзакции, которые могут быть переданы в ответе платежного шлюза по согласованию со службой поддержки Payture Описание формата и возможных параметров доступно здесь | Object Optional |
| ErrCode | Код ошибки. См. коды ошибок Передается, если «Success=False» | String Optional |
Зарегистрированная карта
Команда Pay для выполнения списания или блокировки средств с зарегистрированной карты Покупателя. Карта должна находится в статусе «IsActive». В запросе необходимо передать идентификатор ранее добавленной карты — CardId.
PaySubmit3DS
Команда PaySubmit3DS служит для завершения списания или блокирования средств на карте, защищенной 3-D Secure. Выполняется после запроса Pay — на стороне Продавца и получения результатов 3‑D Secure аутентификации от…
