Payture eWallet

Pay

https://{Environment}.payture.com/vwapi/Pay

Запрос vwapi/Pay c передачей PayToken используется для совершения платежа с использованием систем Apple Pay, Google Pay или Samsung Pay.

Платеж может быть выполнен по одностадийной (SessionType=Pay) или по двухстадийной схеме (SessionType=Block).

Запрос

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=FreePay; \
OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea; \
Amount=12480; \
PayToken={PayToken}; \
SessionType=Block; \
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	Для платежей Apple Pay, Google Pay и Samsung Pay необходимо передавать значение `CardId=FreePay`	String [36] Mandatory
OrderId	Уникальный идентификатор платежа в системе Продавца Рекомендуемый формат: GUID/UUID или Alphanumeric. Другие форматы могут вызвать сбои в работе банковских сервисов.	String [1..50] Mandatory
Amount	Сумма платежа в копейках (или другая минимальная единица валюты терминала) Для текущего запроса сумма платежа всегда используется из запроса (не из токена). Сумма должна совпадать со значением в токене	Integer Mandatory
PayToken	Платежные данные: для Apple Pay — paymentData из PKPaymentToken в кодировке Base64 для Google Pay — token из paymentData в кодировке Base64 для Samsung Pay — paymentCredential в кодировке Base64 String Mandatory	String Mandatory
SessionType	Тип платежа. Определяет количество стадий платежа: `Pay` — одностадийный платеж (по умолчанию) `Block` — двухстадийный платеж	String Optional
AddCard	Признак сохранения карты True — необходимо добавить карту. По умолчанию False	Boolean Optional
SecureCode	CVV2/CVC2 код Параметр обязателен при оплате нетокенизированной картой через Google Pay	Integer Optional
IP	IP адрес Покупателя IPv4 или IPv6	String Optional
Cheque	Информация о чеке в формате JSON, закодированная в Base64	String Optional
Дополнительные параметры	Любые дополнительные параметры Продавца Дополнительных параметров может быть несколько. Каждый параметр передается отдельно	— Optional

Пример параметра DATA (decoded):

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=FreePay;
OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea;
Amount=12480;
PayToken={PayToken};
SessionType=Block;
SecureCode=123;
IP=241.22.197.12;
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	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
ACSUrl	Адрес сервера аутентификации 3-D Secure Передается, если «Success=3DS»	String Optional
PaReq	Запрос на аутентификацию 3-D Secure Передается, если «Success=3DS»	String Optional
ThreeDSKey	Уникальный идентификатор транзакции (MD) Передается, если «Success=3DS»	String Optional
ThreeDSVersion	Версия протокола 3-D Secure: 1.0 — первая версия 2.1 — вторая версия Передается, если «Success=3DS»	String Optional
AddInfo	Дополнительные параметры транзакции, которые могут быть переданы в ответе платежного шлюза по согласованию со службой поддержки Payture Описание формата и возможных параметров доступно здесь	Object Optional
ErrCode	Код ошибки. См. коды ошибок Передается, если «Success=False»	String Optional

Add

https://{Environment}.payture.com/vwapi/Add

Запрос vwapi/Add с передачей PayToken используется для привязки карты из Apple Pay, Google Pay или Samsung Pay перед выполнением рекуррентных платежей.