Init
https://{Environment}.payture.com/vwapi/InitКоманда инициализации одностадийного, двухстадийного платежа или процесса добавления карты. Результатом выполнения запроса является создание сессии и подготовка к перенаправлению Покупателя на страницу платежного шлюза Payture для ввода данных банковской карты.
Запрос
curl https://sandbox3.payture.com/vwapi/Init \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
SessionType=Pay; \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea; \
Amount=12480; \
Product=Ticket; \
Total=124.8; \
Description=MyTestTransaction; \
PhoneNumber=79156783333; \
Url=https://payture.com/result?orderid={orderid}&result={success}; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \В запросах наименования параметров чувствительны к регистру
| Параметр | Описание | Формат |
|---|---|---|
| VWID | Наименование платежного Терминала Предоставляется с параметрами тестового/рабочего доступа | String Mandatory |
| DATA | Параметры платежа Url Encoded строка, содержащая пары ключей и их значений, разделённые символом «;» (точка с запятой). Ключи и значения разделены символом «=» (равно) | String Mandatory |
Состав ключей параметра DATA
Параметры
{success},{orderid}указываются в нижнем регистре.
| Параметр | Описание | Формат |
|---|---|---|
| SessionType | Тип платежа. Определяет количество стадий платежа:Add — регистрация картыPay — одностадийный платежBlock — двухстадийный платеж | String Mandatory |
| VWUserLgn | Идентификатор Покупателя в системе Payture | String [1..50] Mandatory |
| VWUserPsw | Дополнительный параметр доступа к приватной информации Покупателя (пароль Покупателя) | String [1..50] Mandatory |
| OrderId | Уникальный идентификатор платежа в системе Продавца Параметр обязателен, если «SessionType=Pay» или «SessionType=Block» Рекомендуемый формат: GUID/UUID или Alphanumeric. Другие форматы могут вызвать сбои в работе банковских сервисов. | String [1..50] Optional |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Параметр обязателен, если «SessionType=Pay» или «SessionType=Block» | Integer Optional |
| Url | Адрес возврата Покупателя после совершения платежа. В адресе возврата дополнительно могут передаваться параметры Success и OrderIdВ общем случае адрес возврата можно настроить для платежного Терминала через службу поддержки Payture и не передавать | String Optional |
| CardId | Идентификатор зарегистрированной карты Покупателя в статусе «IsActive», которая будет выбрана по умолчанию на странице оплаты Может быть передан, если «SessionType=Pay» или «SessionType=Block» | String [36] Optional |
| Product | Название оплачиваемой покупки, которое будет выведено Покупателю на странице оплаты | String [1..50] Optional |
| Total | Сумма заказа, которая будет выведена Покупателю на странице оплаты Используйте это поле, если хотите изменить формат суммы по умолчанию | String [1..50] Optional |
| TemplateTag | Название используемого шаблона страницы оплаты Необходимо передавать, если Продавец применяет несколько шаблонов. Если параметр не передан, используется шаблон с названием «Default». См. подробнее о шаблонах страниц оплаты | String [1..50] Optional |
| Language | Язык шаблона страницы оплаты Необходимо передавать, если для шаблона используется несколько языков. Если параметр не передан, используется язык шаблона «Default». См. подробнее о шаблонах страниц оплаты | String [1..50] Optional |
| PhoneNumber | Номер телефона Покупателя Только цифры, без разделителей. Формат: [код страны][код оператора][номер абонента] | String Optional |
| Email Покупателя Может передаваться, если не используется в качестве VWUserLgn | String [1..50] Optional | |
| Description | Дополнительное описание платежа | String Optional |
| IP | IP адрес Покупателя IPv4 или IPv6 | String Optional |
| Cheque | Информация о чеке в формате JSON, закодированная в Base64 | String Optional |
| Дополнительные параметры | Любые дополнительные параметры Продавца Дополнительных параметров может быть несколько. Каждый параметр передается отдельно | — Optional |
Пример параметра DATA (decoded):
SessionType=Pay;
VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
OrderId=5f63838d-fb03-00c6-c890-c67cfc1c54ea;
Amount=12480;
Product=Ticket;
Total=124.8;
Description=MyTestTransaction;
PhoneNumber=79156783333;
Url=https://payture.com/result?orderid={orderid}&result={success};
AdditionalField1=Value1;
AdditionalField2=Value2Пример параметра Url (адрес возврата):
https://server.com/result?orderid={orderid}&result={success}Ответ
XML строка с элементом Init
Примеры ответов
<Init Success="True" OrderId="5f63838d-fb03-00c6-c890-c67cfc1c54ea" Amount="12480" SessionLifeTime="60" AttemptsCount="5" SessionId="c8cc6c5c-30da-d7e1-e090-46f25ae30626" SessionType="Block"/>| Параметр | Описание | Формат |
|---|---|---|
| Success | Признак успешности операции. Принимает значения:True — операция успешнаFalse — операция неуспешна | String Mandatory |
| OrderId | Идентификатор платежа в системе Продавца Передается, если «Success=True» и «SessionType=Pay» (Block). Соответствует переданному в запросе | String [1..50] Optional |
| Amount | Сумма платежа в копейках (или другая минимальная единица валюты терминала) Передается, если «Success=True». Равен «0», если «SessionType=Add» | Integer Optional |
| SessionLifeTime | Срок жизни платежной сессии с момента получения в ответе Init (в минутах) Передается, если «Success=True». По умолчанию 60 минут. Значение может быть изменено через службу поддержки Payture | Integer Optional |
| AttemptsCount | Количество попыток оплаты, которое будет у Покупателя на странице оплаты в рамках текущей сессии Передается, если «Success=True». По умолчанию 5 попыток. Количество может быть изменено через службу поддержки Payture | Integer Optional |
| SessionId | Идентификатор платежной сессии в системе Payture Передается, если «Success=True» | String [36] Optional |
| ErrCode | Код ошибки. См. коды ошибок Передается, если «Success=False» | String Optional |
GetList
Команда GetList позволяет получить список платежных карт Покупателя, зарегистрированных в системе Payture. GetList не возвращает удаленные карты и карты с истекшим сроком действия.
Pay — на стороне Payture
Команда открытия страницы оплаты на стороне платежного шлюза Payture. Выполняется после успешной команды инициализации платежа Init.
