Справочная информация

С технической точки зрения, прием банковской карты к оплате всегда сводится к процессу списания средств с карты Покупателя. Здесь и далее этот процесс списания называется «платежом». Платеж может состоять из одной операции или последовательности операций.

Термины и определения

Покупатель — держатель карты, совершающий покупку в магазине Продавца.

Продавец (также «ТСП», «мерчант») — это юридическое лицо/индивидуальный предприниматель, осуществляющее (-ий) продажу товаров или услуг через Интернет.

Банк-эквайер — банк, осуществляющий первичную обработку транзакций, проводимых по банковским картам, в пользу Продавца, являющегося клиентом этого банка.

Банк-эмитент — банк, выпустивший карту Покупателя.

МПС — международная платежная система.

Терминал — программное средство, обеспечивающее автоматизированный прием платежей. Имеет совокупность настроек, определяющих правила проведения платежа.

Страница оплаты — HTML-страница, которая используется Покупателем для ввода платежных реквизитов банковской карты.

Транзакция — это совокупность операций взаимодействия держателя банковской карты с процессинговым центром при осуществлении онлайн-платежа по карте. Транзакция изменяет состояние карточного счета. Каждая транзакция имеет свой уникальный идентификатор.

Операция — совокупность действий, результатом которых является изменение статуса транзакции и состояния карточного счета.
Пример: операция списания; блокирование средств; возврат; отмена блокировки.

Одностадийный платеж — платеж, состоящий из единственной операции — прямого списания средств с карты Покупателя.

Двухстадийный платеж — платеж, который включает выполнение двух операций: блокирование средств на карте и завершение авторизации — списание.

Блокирование (также «блокировка», «авторизация» или «холдирование» средств) — предварительное резервирование средств на карте Покупателя.

Списание — выполнение фактического списания денежных средств со счета Покупателя.

Списание в рамках двухстадийного платежа должно быть инициализировано Продавцом в течение 7 дней после успешной блокировки. Если списание не будет инициализировано в указанный срок, то возможно оспаривание операции в связи с нарушением правил МПС. Также эмитент может самостоятельно осуществить автоматическую разблокировку средств на карте покупателя. Завершение после этого уже может быть недоступно.

Отмена блокировки (также «отмена», «разблокировка» или «отмена авторизации») — операция, обратная блокировке. Выполняется в рамках двухстадийного платежа.

Возврат — операция, обратная списанию. Выполняется после списания как при одностадийном, так и при двухстадийном платеже.

Рекуррентный платеж (также «автоплатеж») — платеж по ранее добавленной карте без повторного ввода реквизитов банковской карты, инициированный Продавцом. Для выполнения рекуррентных платежей необходимо получение согласия у Покупателя при первом платеже.
Пример: ежемесячное списание абонентской платы за подписку в онлайн кинотеатре; автоматическое пополнение мобильного телефона при снижении баланса ниже 100 рублей.

Рекарринговый платеж — платеж по ранее добавленной карте без повторного ввода реквизитов банковской карты, инициированный Покупателем.
Пример: заказ и оплата такси через приложение в один клик.

Чарджбэк (Chargeback) — процедура опротестования транзакции Покупателем, при которой сумма платежа безакцептно списывается с Продавца и возвращается Покупателю. После чего обязанность доказательства истинности транзакции ложится на Продавца.

3-D Secure (3DS) — протокол, который используется как дополнительный уровень безопасности Интернет-платежей по кредитным и дебетовым картам. Основная концепция протокола — добавить к процессу финансовой авторизации онлайн-проверку подлинности держателя карты.

Порядок (место) ввода данных банковской карты

Платежи делятся не только на одностадийные и двухстадийные, также возможны различия в проведении платежа в зависимости от способа ввода данных платежной карты. В одном варианте интеграции Покупатель вводит параметры своей карты на странице веб-сайта Продавца, во втором случае — на веб-странице Payture.

На странице Продавца

В данном случае Покупатель в течение всего платежа находится на сайте / в приложении Продавца, где и осуществляет ввод данных своей платежной карты для проведения операции. Введенные данные Продавец передает в запросе на выполнение платежа.

Внимание! В целях безопасности основные международные платежные системы требуют от стороны, оперирующей данными платежных карт, соответствовать требованиям стандарта безопасности PCI DSS. Для подтверждения соответствия этому стандарту организации (Продавцу) необходимо, как правило, заполнить самоопросник SAQ категории D и пройти его верификацию, которая может повлечь дополнительные, хоть и небольшие, финансовые и организационные затраты.

На стороне Payture

При таком варианте Продавец не обрабатывает платежные данные на своей стороне и избавлен от необходимости самостоятельно обеспечивать безопасность данных. Ввод платежной информации и непосредственно совершение оплаты выполняется на стороне платежного шлюза Payture:

• На странице оплаты Payture — в данном случае Покупатель находится на сайте Продавца только до момента ввода данных своей платежной карты, после чего автоматически перенаправляется на защищенную страницу Payture. После оплаты Покупатель будет проинформирован о результатах операции и возвращен обратно на сайт Продавца, а Продавцу будут отправлены нотификации с результатами платежа.
• Через платежный виджет — всплывающее окно, которое встраивается на сайт Продавца и появляется при нажатии на кнопку «Оплатить». Включает защищенные поля ввода платежных данных (данные обрабатывает Payture в соответствии со стандартами безопасности).

Вид страницы оплаты или виджета определяется применяемым шаблоном. Стандартные шаблоны Payture могут изменены по желанию Продавца. Продавец может использовать один или несколько различных шаблонов.

Работа с API

Взаимодействие решения Продавца с платежным шлюзом Payture строится по схеме запрос-ответ.

Запрос

Запрос с необходимыми параметрами формируется на стороне Продавца и передается методом GET или POST по протоколу HTTPS. Значение заголовка «Content-Type» для запроса POST должно быть установлено «application/x-www-form-urlencoded».

URL запроса:

https://{Environment}.payture.com/{Interface}/{Command}

{Environment} — программная среда, предоставляется с параметрами тестового и рабочего доступа
{Interface} — используемый программный интерфейс
{Command} — название выполняемой команды

Ответ

Результаты обработки запросов возвращаются платежным шлюзом в формате XML, кодировка UTF-8.

Структура ответа:

<{Command} Key1="Value1" Key2="Value2"/>

Payture API

Программный интерфейс Payture API является производительным и удобным решением для автоматизированного выполнения операций электронной коммерции. Платежный шлюз Payture гарантирует высокую надежность и защищенность платежных операций.

Обязательная верификация

Для интерфейса Payture API ввод данных платежных карт выполняется непосредственно на веб-сайте или в мобильном приложении Продавца. В таком случае для обеспечения безопасности платежей основные международные платежные системы требуют от стороны, оперирующей данными платежных карт, соответствовать требованиям стандарта безопасности PCI DSS. Для подтверждения соответствия этому стандарту Продавцу необходимо заполнить самоопросник SAQ категории D и пройти его верификацию. Это может повлечь дополнительные финансовые и организационные затраты.

Возможности

Схема взаимодействия

Обратите внимание, при использовании аутентификации 3-D Secure порядок выполнения операции незначительно изменяется, как описано в разделе 3-D Secure.

Pay

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

Команда Pay используется для выполнения платежа по одностадийной схеме.

Результатом обработки запроса является списание денежных средств с карты Покупателя. Списанные средства могут быть полностью или частично возвращены на карту Покупателя при помощи команды Refund.

Запрос

curl https://sandbox3.payture.com/api/Pay \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Amount=12515 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
--data-urlencode "PayInfo= \
PAN=4011111111111112; \
EMonth=12; \
EYear=22; \
CardHolder=Ivan Ivanov; \
SecureCode=123; \
OrderId=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515" \
--data-urlencode "CustomFields = \
IP=66.114.206.197; \
Product=Ticket" \

В запросах наименования параметров чувствительны к регистру

Состав параметра PayInfo

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

PAN=4011111111111112;
EMonth=12;
EYear=22;
CardHolder=Ivan Ivanov;
SecureCode=123;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515

Внимание! Параметры OrderId и Amount передаются дважды в одном запросе: в основных параметрах запроса и в параметре PayInfo.

Пример возможных ключей параметра CustomFields

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

IP=66.114.206.197;
Description=MyTestTransaction

Ответ

XML строка с элементом Pay

<Pay OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="True" Amount="12515"/>

<Pay OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="False" ErrCode="DUPLICATE_ORDER_ID"/>

<Pay OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="3DS" Amount="12515" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0"/>

Pay3DS

https://{Environment}.payture.com/api/Pay3DS

Команда Pay3DS предназначена для завершения списания средств с платежной карты, защищенной 3-D Secure. Выполняется после запроса Pay и получения результатов 3‑D Secure аутентификации от банка-эмитента.

Запрос

curl https://sandbox3.payture.com/api/Pay3DS \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
-d PaRes={PaRes} \

В запросах наименования параметров чувствительны к регистру

Ответ

Полностью соответствует ответу на запрос Pay.

Block

https://{Environment}.payture.com/api/Block

Команда Block позволяет блокировать денежные средства на карте Покупателя для последующего списания. Выполняется в рамках двухстадийной схемы проведения платежа.

Заблокированные средства далее могут быть списаны командой Charge или разблокированы командой Unblock.

Запрос

curl https://sandbox3.payture.com/api/Block \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Amount=12515 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
--data-urlencode "PayInfo= \
PAN=4011111111111112; \
EMonth=12; \
EYear=22; \
CardHolder=Ivan Ivanov; \
SecureCode=123; \
OrderId=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515" \
--data-urlencode "CustomFields = \
IP=66.114.206.197; \
Product=Ticket" \

В запросах наименования параметров чувствительны к регистру

Состав параметра PayInfo

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

PAN=4011111111111112;
EMonth=12;
EYear=22;
CardHolder=Ivan Ivanov;
SecureCode=123;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515

Внимание! Параметры OrderId и Amount передаются дважды в одном запросе: в основных параметрах запроса и в параметре PayInfo.

Пример возможных ключей параметра CustomFields

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

IP=66.114.206.197;
Description=MyTestTransaction

Ответ

<Block OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="True" Amount="12492"/>

<Block OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="False" ErrCode="DUPLICATE_ORDER_ID"/>

<Block OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="3DS" Amount="12725" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0"/>

XML строка с элементом Block.

Block3DS

https://{Environment}.payture.com/api/Block3DS

Команда Block3DS предназначена для завершения блокирования средств на карте, защищенной 3-D Secure. Выполняется после запроса Block и получения результатов 3‑D Secure аутентификации от банка-эмитента.

Запрос

curl https://sandbox3.payture.com/api/Block3DS \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
-d PaRes={PaRes} \

В запросах наименования параметров чувствительны к регистру

Ответ

Полностью соответствует ответу на запрос Block.

Charge

https://{Environment}.payture.com/api/Charge

Команда Charge используется для списания денежных средств с карты Покупателя, предварительно заблокированных командой Block. Выполняется в рамках двухстадийной схемы проведения платежа.

Результатом обработки запроса является списание с карты Покупателя суммы, не превышающей заблокированной (равной или меньшей).

Внимание! Для успешного списания необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized.

Параметры запроса

curl https://sandbox3.payture.com/api/Charge \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Charge

<Charge Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Amount="12564"/>

<Charge Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="ORDER_NOT_FOUND"/>

Unblock

https://{Environment}.payture.com/api/Unblock

Команда Unblock позволяет полностью разблокировать денежные средства, предварительно заблокированные командой Block. Выполняется в рамках двухстадийной схемы проведения платежа.

Результатом обработки запроса является полная отмена блокировки суммы, заблокированной на карте Покупателя.

Внимание! Для успешной разблокировки средств необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized.

curl https://sandbox3.payture.com/api/Unblock \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Запрос

Ответ

XML строка с элементом Unblock

<Unblock Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" NewAmount="0"/>

<Unblock Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="ILLEGAL_ORDER_STATE"/>

Refund

https://{Environment}.payture.com/api/Refund

Команда Refund используется для возврата денежных средств, списанных командой Pay или Charge, на карту Покупателя. Выполняется как при одностадийной, так и при двухстадийной схеме проведения платежа.

Результатом обработки запроса является полный или частичный возврат денежных средств на карту Покупателя.

Внимание! Для успешного возврата необходимо, чтобы на момент исполнения запроса платеж имел статус Charged.

Запрос

curl https://sandbox3.payture.com/api/Refund \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Password=123 \
-d Amount=12515 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Refund.

<Refund Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" NewAmount="0"/>

<Refund Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="PROCESSING_TIME_OUT"/>

GetRefunds

https://{Environment}.payture.com/api/GetRefunds

Команда GetRefunds используется для получения списка возвратов по заказу.

Запрос

curl https://sandbox3.payture.com/api/GetRefunds \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом GetRefunds

<GetRefunds Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Forwarded="True" MerchantContract="Merchant" 
FinalTerminal="Merchant" State="Charged" Amount="300000" NewAmount="100000"> 
<Item RefundDateTime="2023.08.17 18:22:07" RefundAmount="150000" RefundNewAmount="150000"/> 
</Item> 
<Item RefundDateTime="2023.10.19 19:12:07" RefundAmount="50000" RefundNewAmount="100000"/>
</Item> 
<GetRefunds/>

<GetRefunds Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" Forwarded="false" State="" ErrCode="ACCESS_DENIED"/>

Атрибуты элемента Item

GetState

https://{Environment}.payture.com/api/GetState

Команда GetState используется для получения актуального статуса платежа.

Запрос

curl https://sandbox3.payture.com/api/GetState \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом GetState

<GetState Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" State="Refunded" Forwarded="False" MerchantContract="Merchant" Amount="12515" RRN="003770024290"/>

<GetState Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" State="" Forwarded="False" ErrCode="ORDER_NOT_FOUND"/>

Payture InPay

InPay — это простой способ приема платежей без сохранения карт. При использовании программного интерфейса InPay данные банковской карты вводятся на стороне платежного шлюза Payture, поэтому от Продавца не требуется верификация по стандарту PCI DSS – защиту информации обеспечивает Payture.

Покупатель находится на сайте Продавца только до момента ввода данных своей платежной карты. Для оплаты Покупатель перенаправляется на защищенную страницу оплаты Payture. После оплаты Покупатель будет проинформирован о результатах операции и возвращен на страницу Продавца, а Продавцу будут отправлены нотификации с результатами платежа.

Страница оплаты

Продавец может как напрямую перенаправлять Покупателя на страницу оплаты Payture, так и открывать ее в iframe на сайте магазина или в режиме WebView в мобильном приложении.

Внешний вид стандартной страницы оплаты может быть изменен по желанию Продавца. Для этого Продавцу необходимо подготовить один или несколько шаблонов страницы оплаты. Информацию и подробные технические сведения о создании шаблонов Вы можете изучить здесь.

Возможности

Помимо стандартной оплаты с банковской карты, платежная страница Payture поддерживает мобильные способы оплаты Apple Pay, Google Pay, Samsung Pay и SberPay. Их использование не требует от Продавца сложных изменений — все необходимые интеграции уже реализованы на стороне Payture.

Для дополнительной проверки Покупателя на странице оплаты Payture выполняется его аутентификация по протоколу 3-D Secure, если эта процедура доступна для используемой карты.

Стандартный набор операций электронной коммерции для интерфейса InPay

Интеграция

Init

https://{Environment}.payture.com/apim/Init

Команда инициализации одностадийного или двухстадийного платежа. Результатом выполнения запроса является создание платежной сессии и подготовка к перенаправлению Покупателя на страницу платежного шлюза Payture для ввода данных банковской карты.

Запрос

curl https://sandbox3.payture.com/apim/Init \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
--data-urlencode "Data= \
SessionType=Pay; \
OrderId=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515; \
Product=Ticket; \
Total=125.15; \
Phone=79156783333; \
Description=MyTestTransaction; \
Url=https://payture.com/result?orderid={orderid}&result={success}; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \

В запросах наименования параметров чувствительны к регистру

Состав параметра Data

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

SessionType=Pay;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515;
Total=125.15;
Product=Ticket;
Phone=79156783333;
Description=MyTestTransaction;
Url=https://payture.com/result?orderid={orderid}&result={success};
AdditionalField1=Value1;
AdditionalField2=Value2

Пример параметра Url (адрес возврата):

https://server.com/result?orderid={orderid}&result={success}

Параметры {success}, {orderid} указываются в нижнем регистре.

Ответ

XML строка с элементом Init

<Init Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Amount="12515" SessionLifeTime="60" AttemptsCount="5" SessionId="d039d41b-1af7-6da5-3d29-9a622795dd6c"/>

<Init Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="AMOUNT_ERROR"/>

Pay

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

Команда открытия страницы оплаты на стороне платежного шлюза Payture. Выполняется после успешной команды инициализации платежа Init.

Запрос может быть отправлен GET или POST методом.

Запрос

curl https://sandbox3.payture.com/apim/Pay \
-d SessionId=d039d41b-1af7-6da5-3d29-9a622795dd6c \

В запросах наименования параметров чувствительны к регистру

Результат успешной операции — открытие страницы оплаты на стороне платежного шлюза Payture.

После указания данных банковской карты Покупателя будет выполнено списание (при одностадийном платеже) или блокирование средств (при двухстадийном платеже) на карте Покупателя.

Результаты операции будут показаны Покупателю на платежной странице, и через 3 секунды он будет перенаправлен на страницу возврата (параметр Url запроса Init).

Charge

https://{Environment}.payture.com/apim/Charge

Команда Charge используется для списания заблокированных денежных средств с карты Покупателя. Выполняется в рамках двухстадийной схемы проведения платежа.

Результатом обработки запроса является списание с карты Покупателя суммы, не превышающей заблокированной (равной или меньшей).

Внимание! Для успешного списания необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized.

Запрос

curl https://sandbox3.payture.com/apim/Charge \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Password=123 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Charge

<Charge Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Amount="12515"/>

<Charge Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="ILLEGAL_ORDER_STATE"/>

Unblock

https://{Environment}.payture.com/apim/Unblock

Запрос позволяет полностью разблокировать денежные средства, ранее заблокированные на карте Покупателя. Выполняется в рамках двухстадийной схемы проведения платежа.

Результатом обработки запроса является полная отмена блокировки.

Внимание! Для успешной разблокировки средств необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized.

Запрос

curl https://sandbox3.payture.com/apim/Unblock \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Password=123 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Unblock

<Unblock Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" NewAmount="0"/>

<Unblock Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="ILLEGAL_ORDER_STATE"/>

Refund

https://{Environment}.payture.com/apim/Refund

Эта команда используется для возврата денежных средств, списанных при одностадийном или двухстадийном платеже.

Результатом обработки запроса является полный или частичный возврат списанных денежных средств на карту Покупателя.

Внимание! Для успешного возврата необходимо, чтобы на момент исполнения запроса платеж имел статус Charged.

Запрос

curl https://sandbox3.payture.com/apim/Refund \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d Password=123 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
-d Amount=12515 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Refund

<Refund Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" NewAmount="2000"/>

<Refund Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="AMOUNT_ERROR"/>

GetRefunds

https://{Environment}.payture.com/apim/GetRefunds

Команда GetRefunds используется для получения списка возвратов по заказу.

Запрос

curl https://sandbox3.payture.com/apim/GetRefunds \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом GetRefunds

<GetRefunds Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Forwarded="True" MerchantContract="Merchant" 
FinalTerminal="Merchant" State="Charged" Amount="300000" NewAmount="100000"> 
<Item RefundDateTime="2023.08.17 18:22:07" RefundAmount="150000" RefundNewAmount="150000"/> 
</Item> 
<Item RefundDateTime="2023.10.19 19:12:07" RefundAmount="50000" RefundNewAmount="100000"/>
</Item> 
<GetRefunds/>

<GetRefunds Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" Forwarded="false" State="" ErrCode="ACCESS_DENIED"/>

Атрибуты элемента Item

GetState

https://{Environment}.payture.com/apim/GetState

Команда GetState используется для получения актуального статуса платежа.

Запрос

curl https://sandbox3.payture.com/apim/GetState \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом GetState

<GetState Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" State="Refunded" Forwarded="False" MerchantContract="Merchant" Amount="12515" RRN="003770024290"/>

<GetState Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" State="" Forwarded="False" ErrCode="ORDER_NOT_FOUND"/>

Payture eWallet

Программный интерфейс Payture eWallet предоставляет дополнительные возможности по регистрации Покупателей и привязке платежных карт к учетным записям зарегистрированных Покупателей. Это позволяет выполнять рекуррентные платежи и оплату сохраненной картой без повторного ввода карточных данных, в том числе one-click платежи.

Способы ввода данных платежных карт

Интерфейс eWallet поддерживает два варианта реализации, в зависимости от места ввода данных платежных карт.

Во втором случае Продавец должен соответствовать требованиям стандарта безопасности PCI DSS, чтобы гарантировать достаточный уровень защищенности вводимых данных. Для подтверждения соответствия этому стандарту Продавцу необходимо, как правило, заполнить самоопросник SAQ категории D и пройти его верификацию, которая может повлечь дополнительные, хоть и небольшие, финансовые и организационные затраты.

Если у Вас нет возможности пройти верификацию по стандарту PCI DSS, Вы не сможете использовать второй вариант. В этом случае мы рекомендуем использовать реализацию, когда ввод данных карты выполняется на стороне платежного шлюза Payture.

Страница оплаты на стороне Payture

Если Вы выбрали реализацию с вводом карточных данных на странице платежного шлюза Payture, то Вы можете использовать стандартную страницу оплаты Payture или подготовить собственный шаблон. Информация и подробные технические сведения о создании шаблонов представлены здесь. Вы можете как создать собственный шаблон с нуля, так и изменить готовые шаблоны Payture.

Продавец может как напрямую перенаправлять Покупателя на страницу оплаты Payture, так и открывать ее в iframe на сайте магазина или в режиме WebView в мобильном приложении.

Стандартный набор операций электронной коммерции для интерфейса eWallet

Интеграция

Покупатели

Payture eWallet предлагает набор функций по управлению учетными записями Покупателей. Эта функциональность позволяет решать такие задачи, как создание новой учетной записи, изменение параметров или же удаление учетной записи.

Register

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

Команда Register служит для регистрации нового Покупателя в платежной системе Payture. Для использования функциональности интерфейса eWallet каждый Покупатель должен быть зарегистрирован в системе Payture.

Система Payture также позволяет регистрировать Покупателя не отдельной командой Register, а делать это автоматически при успешном добавлении карты. Для активации этой опции, пожалуйста, обратитесь в службу поддержки Payture.

Запрос

curl https://sandbox3.payture.com/vwapi/Register \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
PhoneNumber=79156783333" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
PhoneNumber=79156783333

Ответ

XML строка с элементом Register

<Register Success="True" VWUserLgn="123@ya.ru"/>

<Register Success="False" VWUserLgn="123@ya.ru" ErrCode="DUPLICATE_USER"/>

Update

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

Команда позволяет редактировать параметры учетной записи Покупателя (PhoneNumber или Email), зарегистрированного ранее в системе Payture.

Запрос

curl https://sandbox3.payture.com/vwapi/Update \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
PhoneNumber=79156783333" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
PhoneNumber=79156783333

Ответ

XML строка с элементом Update

<Update Success="True" VWUserLgn="123@ya.ru"/>

<Update Success="False" VWUserLgn="123@ya.ru" ErrCode="DUPLICATE_USER"/>

Delete

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

Команда для удаления учетной записи Покупателя, а также всех его карт в системе Payture.

Запрос

curl https://sandbox3.payture.com/vwapi/Delete \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
Password=123" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
Password=123

Ответ

XML строка с элементом Delete

<Delete Success="True" VWUserLgn="123@ya.ru"/>

<Delete Success="False" VWUserLgn="" ErrCode="ACCESS_DENIED"/>

Check

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

Команда Check служит для проверки существования Покупателя в платежной системе Payture (Покупателя с такими VWUserLgn и VWUserPsw).

Запрос

curl https://sandbox3.payture.com/vwapi/Check \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363

Ответ

XML строка с элементом Check

<Check Success="True" VWUserLgn="123@ya.ru"/>

<Check Success="False" VWUserLgn="123@ya.ru" ErrCode="USER_NOT_FOUND"/>

Карты

В этом разделе описаны функции по управлению картами Покупателей в интерфейсе eWallet (привязка карты к учетной записи Покупателя, активация карты, удаление карты и т.д.)

Add

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

Команда регистрации новой карты в системе Payture.

Обратите внимание, что в некоторых случаях (когда это предполагается используемой схемой добавления карты) необходимо не только добавить карту, но и активировать ее. Платежи по зарегистрированной карте возможны только после активации. Как правило, для активации происходит блокирование и последующая отмена блокировки небольшой проверочной суммы.

Карта может быть добавлена не только командой Add, но и при выполнении платежа.

В зависимости от наличия у Продавца сертификата PCI DSS, регистрация карты может проводится на веб-странице продавца или на шаблоне платежного шлюза Payture.

На стороне Payture

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

Команда открытия страницы добавления карты на стороне платежного шлюза Payture. Выполняется после успешной команды инициализации Init.

Схема взаимодействия

Запрос Add

curl https://sandbox3.payture.com/vwapi/Add \
-d SessionId=d039d41b-1af7-6da5-3d29-9a622795dd6c \

В запросах наименования параметров чувствительны к регистру

Запрос может быть отправлен GET или POST методом.

Результат успешной операции — открытие страницы добавления карты на стороне платежного шлюза Payture.

Результаты добавления карты будут показаны Покупателю, и через 3 секунды он будет перенаправлен на страницу возврата (параметр Url запроса Init).

На стороне Продавца

Команда регистрации новой платежной карты непосредственно на веб-странице Продавца.

Схема взаимодействия

Обратите внимание, при использовании аутентификации 3-D Secure порядок выполнения операции незначительно изменяется, как описано в разделе 3-D Secure.

Запрос Add

curl https://sandbox3.payture.com/vwapi/Add \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=VWMerchantside \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
CardNumber=4011111111111112; \
EMonth=12; \
EYear=22; \
CardHolder=Ivan Ivanov; \
SecureCode=123; \
PhoneNumber=79156783333; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardNumber=4011111111111112;
EMonth=12;
EYear=22;
CardHolder=Ivan Ivanov;
SecureCode=123;
PhoneNumber=79156783333;
AdditionalField1=Value1;
AdditionalField2=Value2

Ответ

XML строка с элементом Add

<Add VWUserLgn="123@ya.ru" Success="True" CardName="521885xxxxxx5484" CardId="5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85"/>

<Add VWUserLgn="123@ya.ru" Success="False" ErrCode="WRONG_CARD_INFO"/>

<Add VWUserLgn="123@ya.ru" Success="3DS" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0" CardName="521885xxxxxx5484" CardId="5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85"/>

AddSubmit3DS

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

Команда AddSubmit3DS используется для завершения добавления карты, защищенной 3-D Secure. Выполняется после запроса Add — на стороне Продавца и получения результатов 3‑D Secure аутентификации от банка-эмитента.

Используется только при вводе карточных данных на стороне Продавца.

Запрос

curl https://sandbox3.payture.com/vwapi/AddSubmit3DS \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d MD=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85 \
-d PaRes={PaRes} \

В запросах наименования параметров чувствительны к регистру

Ответ

Полностью соответствует ответу на запрос Add — на стороне Продавца.

Activate

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

Команда Activate используется для активации карты, ранее зарегистрированной в системе Payture и ожидающей активации. Метод используется, если для проверки карты применяется схема добавления с блокировкой небольшой суммы.

В запросе Activate необходимо указать сумму, заблокированную на карте при добавлении через Add. В случае корректного ввода заблокированной суммы Покупателем, карта будет активирована и заблокированные денежные средства будут разблокированы. В случае некорректного ввода денежные средства разблокируются по отдельному запросу.

Запрос

curl https://sandbox3.payture.com/vwapi/Activate \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
CardId=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85; \
Amount=101" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85;
Amount=12515

Ответ

XML строка с элементом Activate

<Activate Success="True" VWUserLgn="123@ya.ru" CardId="5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85"/>

<Activate Success="False" VWUserLgn="123@ya.ru" ErrCode="CARD_NOT_FOUND"/>

Remove

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

Команда для удаления данных платежной карты (как активированной, так и неактивированной) из списка карт Покупателя.

Запрос

curl https://sandbox3.payture.com/vwapi/Remove \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363; \
CardId=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85

Ответ

XML строка с элементом Remove

<Remove Success="True" VWUserLgn="123@ya.ru" CardId="5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85"/>

<Remove Success="False" VWUserLgn="123@ya.ru" ErrCode="WRONG_CARD_INFO"/>

GetList

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

Команда GetList позволяет получить список платежных карт Покупателя, зарегистрированных в системе Payture. GetList не возвращает удаленные карты и карты с истекшим сроком действия.

Максимальное количество карт в ответе GetList: 20. Карты сортируются по дате последней успешной операции списания или блокирования денежных средств.

Запрос

curl https://sandbox3.payture.com/vwapi/GetList \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
VWUserLgn=123@ya.ru; \
VWUserPsw=2645363" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363

Ответ

XML строка с элементом GetList и вложенными элементами Item

<GetList Success="True" VWUserLgn="123@ya.ru">
  <Item CardName="411111xxxxxx1112" CardId="e5dfa016-27e0-45bb-8167-44299642b529" CardHolder="Ivan Ivanov" Status="NotActive" NoCVV="false" Expired="false" ExpMonth="12" ExpYear="2022" PaymentSystem="Visa"/>
    <Param Key="ExternalWallet" Value="ApplePay" />
    <Param Key="CAVV" Value="/oasQvoGZxvwxyU5V/RYMAACAAA=" />
    <Param Key="BindingOrderId" Value="d5f8531f-308b-4470-96c9-e56be812896b" />
    <Param Key="LastSuccess" Value="2019.08.17 18:22:07" />
    <Param Key="LastSuccessOrderId" Value="4b7638ef-c1bf-4e8b-8530-9bc13825c1d8" />
  </Item>
  <Item CardName="411111xxxxxx1111" CardId="001f2def-64e9-4cef-ae02-aa2bd9508a8b" CardHolder="Ivan Ivanov" Status="IsActive" NoCVV="true" Expired="false" ExpMonth="12" ExpYear="2022" PaymentSystem="Visa">
    <Param Key="LastSuccess" Value="2019.06.24 12:42:14"/>
    <Param Key="LastSuccessOrderId" Value="4b7638ef-c1bf-4e8b-8530-9bc13825c1d8" />
    <Param Key="LastLessSecureCode:VWMerchantTest" Value="True"/>
    <Param Key="BindingOrderId" Value="a760d6a6-4c6f-4687-95c2-e1c7dcc8151f"/>
  </Item>
</GetList>

<GetList Success="False" VWUserLgn="123@ya.ru" ErrCode="WRONG_USER_PARAMS"/>

Атрибуты элемента Item

Возможные атрибуты элемента Param

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=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515; \
Product=Ticket; \
Total=125.15; \
Description=MyTestTransaction; \
PhoneNumber=79156783333; \
Url=https://payture.com/result?orderid={orderid}&result={success}; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

SessionType=Pay;
VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515;
Product=Ticket;
Total=125.15;
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}

Параметры {success}, {orderid} указываются в нижнем регистре.

Ответ

XML строка с элементом Init

<Init Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Amount="12515" SessionLifeTime="60" AttemptsCount="5" SessionId="d039d41b-1af7-6da5-3d29-9a622795dd6c" SessionType="Block"/>

<Init Success="False" ErrCode="ACCESS_DENIED"/>

Pay — на стороне Payture

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

Команда открытия страницы оплаты на стороне платежного шлюза Payture. Выполняется после успешной команды инициализации платежа Init.

На странице оплаты Покупатель сможет выбрать ранее зарегистрированую карту или ввести данные новой карты, по которой будет выполнен платеж.

Схема взаимодействия

Запрос

curl https://sandbox3.payture.com/vwapi/Pay \
-d SessionId=d039d41b-1af7-6da5-3d29-9a622795dd6c \

В запросах наименования параметров чувствительны к регистру

Запрос может быть отправлен GET или POST методом.

Результат успешной операции — открытие страницы оплаты на стороне платежного шлюза Payture.

После указания данных банковской карты Покупателя будет выполнено списание (при одностадийном платеже) или блокирование средств (при двухстадийном платеже) на карте Покупателя.

Результаты операции будут показаны Покупателю на платежной странице, и через 3 секунды он будет перенаправлен на страницу возврата (параметр Url запроса Init).

Pay — на стороне Продавца

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

Команда для выполнения платежа, когда ввод данных платежных карт выполняется непосредственно на веб-странице или в мобильном приложении Продавца. Позволяет выполнить списание средств в рамках одностадийного платежа (SessionType=Pay) или блокирование средств в рамках двухстадийного платежа (SessionType=Block).

При этом возможны два сценария оплаты: зарегистрированной и незарегистрированной картой.

Схема взаимодействия

Обратите внимание, при использовании аутентификации 3-D Secure порядок выполнения операции незначительно изменяется, как описано в разделе 3-D Secure.

Незарегистрированная карта

Команда Pay для выполнения списания или блокировки средств с незарегистрированной ранее карты. В запросе необходимо передать данные банковской карты Покупателя.

Запрос

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=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515; \
CardNumber=4011111111111112; \
CardHolder=Ivan Ivanov; \
EMonth=12; \
EYear=22; \
SecureCode=123; \
PhoneNumber=79156783333; \
IP=66.114.206.197; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=FreePay;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515;
CardNumber=4011111111111112;
CardHolder=Ivan Ivanov;
EMonth=12;
EYear=22;
SecureCode=123;
SessionType=Block;
PhoneNumber=79156783333;
IP=66.114.206.197;
AdditionalField1=Value1;
AdditionalField2=Value2

Ответ

XML строка с элементом Pay

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="True" Amount="12515"/>

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="c3b33136-1180-643b-c159-6ee283970082" Success="False" ErrCode="DUPLICATE_ORDER_ID"/>

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="3DS" Amount="12515" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0"/>

Зарегистрированная карта

Команда Pay для выполнения списания или блокировки средств с зарегистрированной карты Покупателя. Карта должна находится в статусе «IsActive». В запросе необходимо передать идентификатор ранее добавленной карты — CardId.

Запрос

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=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85; \ 
OrderId=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515; \
SecureCode=123; \
IP=66.114.206.197; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515;
SecureCode=123;
SessionType=Block;
IP=66.114.206.197;
AdditionalField1=Value1;
AdditionalField2=Value2

Ответ

XML строка с элементом Pay

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="True" Amount="12515"/>

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="c3b33136-1180-643b-c159-6ee283970082" Success="False" ErrCode="DUPLICATE_ORDER_ID"/>

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="3DS" Amount="12515" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0"/>

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=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85; \
OrderId=c3b33136-1180-643b-c159-6ee283970082; \
Amount=12515; \
AdditionalField1=Value1; \
AdditionalField2=Value2" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85;
OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515;
SessionType=Block;
AdditionalField1=Value1;
AdditionalField2=Value2

Ответ

XML строка с элементом Pay

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="True" Amount="12515"/>

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="c3b33136-1180-643b-c159-6ee283970082" Success="False" ErrCode="DUPLICATE_ORDER_ID"/>

<Pay VWUserLgn="123@ya.ru" OrderId="c3b33136-1180-643b-c159-6ee283970082" MerchantOrderId="[CUSTOMERS_PAY]-[1715289]-[1]" Success="3DS" Amount="12515" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0"/>

PaySubmit3DS

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

Команда PaySubmit3DS служит для завершения списания или блокирования средств на карте, защищенной 3-D Secure. Выполняется после запроса Pay — на стороне Продавца и получения результатов 3‑D Secure аутентификации от банка-эмитента.

Используется только при вводе карточных данных на стороне Продавца.

Запрос

curl https://sandbox3.payture.com/vwapi/PaySubmit3DS \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d MD=5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85 \
-d PaRes={PaRes} \

В запросах наименования параметров чувствительны к регистру

Ответ

Полностью соответствует ответу на запрос Pay — на стороне Продавца.

Charge

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

Команда Charge используется для списания денежных средств с карты Покупателя, предварительно заблокированных командой Pay. Выполняется в рамках двухстадийной схемы проведения платежа.

Результатом обработки запроса является списание с карты Покупателя суммы, не превышающей заблокированной (равной или меньшей).

Внимание! Для успешного списания необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized.

Запрос

curl https://sandbox3.payture.com/vwapi/Charge \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
-d Password=123 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Charge

<Charge Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Amount="12515"/>

<Charge Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="ILLEGAL_ORDER_STATE"/>

Unblock

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

Запрос позволяет полностью разблокировать денежные средства, ранее заблокированные на карте Покупателя. Выполняется в рамках двухстадийной схемы проведения платежа.

Результатом обработки запроса является полная отмена блокировки.

Внимание! Для успешной разблокировки средств необходимо, чтобы на момент исполнения запроса платеж имел статус Authorized.

Запрос

curl https://sandbox3.payture.com/vwapi/Unblock \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
-d Password=123 \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом Unblock

<Unblock Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" NewAmount="0"/>

<Unblock Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="ILLEGAL_ORDER_STATE"/>

Refund

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

Эта команда используется для возврата денежных средств, списанных при одностадийном или двухстадийном платеже.

Результатом обработки запроса является полный или частичный возврат списанных денежных средств на карту Покупателя.

Внимание! Для успешного возврата необходимо, чтобы на момент исполнения запроса платеж имел статус Charged.

Запрос

curl https://sandbox3.payture.com/vwapi/Refund \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d VWID=Merchant \
--data-urlencode "DATA= \
OrderId=c3b33136-1180-643b-c159-6ee283970082; \
Password=123; \
Amount=12515" \

В запросах наименования параметров чувствительны к регистру

Состав ключей параметра DATA

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

OrderId=c3b33136-1180-643b-c159-6ee283970082;
Amount=12515;
Password=123

Ответ

XML строка с элементом Refund

<Refund Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" NewAmount="7800"/>

<Refund Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" ErrCode="AMOUNT_ERROR"/>

GetRefunds

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

Команда GetRefunds используется для получения списка возвратов по заказу.

Запрос

curl https://sandbox3.payture.com/vwapi/GetRefunds \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом GetRefunds

<GetRefunds Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" Forwarded="True" MerchantContract="Merchant" 
FinalTerminal="Merchant" State="Charged" Amount="300000" NewAmount="100000"> 
<Item RefundDateTime="2023.08.17 18:22:07" RefundAmount="150000" RefundNewAmount="150000"/> 
</Item> 
<Item RefundDateTime="2023.10.19 19:12:07" RefundAmount="50000" RefundNewAmount="100000"/>
</Item> 
<GetRefunds/>

<GetRefunds Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" Forwarded="false" State="" ErrCode="ACCESS_DENIED"/>

Атрибуты элемента Item

GetState

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

Команда GetState используется для получения актуального статуса платежа.

Запрос

curl https://sandbox3.payture.com/vwapi/GetState \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \

В запросах наименования параметров чувствительны к регистру

Ответ

XML строка с элементом GetState

<GetState Success="True" OrderId="c3b33136-1180-643b-c159-6ee283970082" State="Refunded" Forwarded="False" MerchantContract="Merchant" Amount="12515" RRN="003770024290" VWUserLgn="123@ya.ru" CardId="5f9468a9-9dfc-2cde-2b27-f6c7e3e27d85" PANMask="521885xxxxxx5484"/>

<GetState Success="False" OrderId="c3b33136-1180-643b-c159-6ee283970082" State="" Forwarded="False" ErrCode="ORDER_NOT_FOUND"/>

3-D Secure 1.0

В целях повышения безопасности платежей большинство банковских карт защищены механизмом аутентификации 3-D Secure.

Порядок обработки запросов для оплаты с карты, защищенной 3-D Secure 1.0, отличается от стандартного и подробно описан ниже.

Проверка участия карты в процедуре 3-­D Secure аутентификации

При получении запроса на выполнение платежа или добавление карты платежный шлюз проверяет доступность 3-D Secure аутентификации.

Если карта Покупателя защищена 3-D Secure, значение параметра Success в синхронном ответе на вызов команд Pay, Block или Add принимает значение «3DS». В таком случае в ответе платежного шлюза передаются параметры ACSUrl, PaReq и ThreeDSKey, необходимые для дальнейшей 3-D Secure аутентификации.

Проведение аутентификации

Пример формы запроса

<body onload="document.form.submit()">
    <form name="form" action="{ACSUrl}" method="post">
        <input type="hidden" name="TermUrl" value="{TermUrl}" />
        <input type="hidden" name="MD" value="{ThreeDSKey}" />
        <input type="hidden" name="PaReq" value="{PaReq}" />
    </form>
</body>

После получения ответа от платежного шлюза Продавец перенаправляет Покупателя на страницу банка-эмитента для дополнительной аутентификации.

Для этого используется POST запрос по адресу, указанному в параметре ACSUrl. В запросе передаются следующие параметры:

Получение результата аутентификации

После выполнения проверки банк-эмитент возвращает Покупателя POST запросом по адресу Продавца, указанному в значении параметра TermUrl. В теле запроса передаются параметры:

Завершение платежа

Наконец, для выполнения списания или блокирования средств на карте, защищенной 3-D Secure, Продавцу необходимо передать в платежный шлюз результаты аутентификации, полученные от банка-эмитента. Для интерфейса Payture API результаты передаются в запросе Pay3DS или Block3DS. Для Payture eWallet — в PaySubmit3DS или AddSubmit3DS.

3-D Secure 2.0

Порядок обработки запросов при аутентификации по протоколу 3-D Secure 2.0 отличается от первой версии протокола 3-D Secure. Основной особенностью протокола 3-D Secure 2.0 и отличием от первой версии является возможность Frictionless аутентификации.

• Frictionless Flow — процесс 3-D Secure аутентификации без участия держателя карты. Для Покупателя процесс оплаты выглядит как платеж без 3DS, а для Продавца платеж остается защищенным 3-D Secure.
• Challenge Flow — процесс 3-D Secure аутентификации с проверкой держателя карты. Для Покупателя процесс проверки выглядит аналогично 3DS 1.0.

Решение о выполнении Frictionless или Challenge аутентификации принимает банк-эмитент на основе анализа параметров транзакции, в том числе информации о браузере Покупателя.

Параметры браузера собираются Продавцом и передаются перед выполнением платежа. Однако эмитент может запросить возможность самостоятельного сбора параметров браузера. Для этого в протоколе 3-D Secure 2.0 используется 3DS Method — открытие скрытого iframe в браузере Покупателя для сбора параметров браузера.

Предварительная аутентификация

Предварительная аутентификация выполняется для проверки версии протокола 3-D Secure и необходимости использования 3DS метода. Для предварительной аутентификации используется запрос api/PreAuth (Payture API) или vwapi/PreAuth (Payture eWallet). Описание методов доступно в документациях 3‑D Secure 2.0 на стороне Продавца и 3‑D Secure 2.0 на шаблоне.

Выполнение 3DS метода

Если в ответе PreAuth переданы параметры ThreeDSServerTransId, ThreeDSMethodURL и ThreeDSMethodNotificationURL, то необходимо выполнение 3DS метода — открытие скрытого iframe в браузере клиента, с помощью которого данные браузера автоматически передаются на сервер банка-эмитента.

В ином случае (если в ответе PreAuth отсутствуют параметры ThreeDSServerTransId, ThreeDSMethodURL и ThreeDSMethodNotificationURL или хотя бы один из этих параметров не имеет значения), открытие скрытого iframe не требуется — переходите к следующему шагу.

Примеры ответов методов apim/PreAuth (Payture API) и vwapi/PreAuth (Payture eWallet) описаны в документациях 3‑D Secure 2.0 на стороне Продавца и 3‑D Secure 2.0 на шаблоне.

Выполнение платежа (добавление карты)

Для оплаты или добавления карты используются следующие методы:

• На стороне продавца — api/Pay, api/Block, api/MobilePay, api/MobileBlock, vwapi/Pay — на стороне Продавца или vwapi/Add — на стороне Продавца
• На стороне Payture — apim/PaySubmit, vwapi/AddSubmit или vwapi/AddSubmit. Описание методов доступно в документации 3‑D Secure 2.0 на шаблоне

Если банк эмитент разрешил выполнение операции по сценарию Frictionless Flow, то платеж выполняется без проверки Покупателя. В ответе на запрос оплаты (добавления карты) передается «Success=True» и отсутствуют параметры 3DS, что говорит о выполненном списании или блокировании средств на карте Покупателя. Процесс оплаты завершен.

В случае, если необходима проверка Покупателя, операция проходит по сценарию Challenge Flow. Дальнейший порядок действий различается в зависимости от того, чья сторона обрабатывает карточные данные. Более подробная информация доступна в документациях 3‑D Secure 2.0 на стороне Продавца и 3‑D Secure 2.0 на шаблоне.

Проверка Покупателя (только для Challenge Flow)

Пример HTML формы

<html><head><title></title></head>
 <body onload="setTimeout(document.forms['form'].submit(), 10000)">
 <form name='form' action='{ACSUrl}' method='post'>
 <input type='hidden' name='creq' value='{CReq}'>
 <input type='hidden' name='threeDSSessionData' value='{ThreeDSSessionData}'>
 </form>
</body></html>

В случае необходимости прохождения аутентификации Продавец перенаправляет Покупателя на страницу банка-эмитента. На странице банка-эмитента выполняется проверка Покупателя, обычно это ввод СМС-кода.

Для перенаправления используется POST запрос по адресу, указанному в параметре ACSUrl. Передаваемые параметры:

При выполнении операции на стороне Payture после выполнения проверки ACS перенаправляет Покупателя POST запросом на шаблон возврата Payture. А с шаблона возврата Покупатель возвращается на сайт Продавца (аналогично сценарию 3DS 1.0).

При выполнении операции на стороне продавца после выполнения проверки ACS возвращает Покупателя POST запросом по адресу, указанному в параметре ChallengeNotificationUrl. В запросе передаются следующие параметры:

Завершение оплаты (только для Challenge Flow на стороне Продавца)

Для завершения списания или блокирования средств на карте, защищенной 3-D Secure, Продавцу необходимо передать в платежный шлюз результаты аутентификации, полученные от ACS.

Для интерфейса Payture API результаты передаются в запросе Pay3DS или Block3DS. Для Payture eWallet — в PaySubmit3DS или AddSubmit3DS. Описание методов доступно в документации 3‑D Secure 2.0 на стороне Продавца.

Платежный виджет

Виджет оплаты — это всплывающее окно (поп-ап), которое встраивается на сайт Продавца и появляется при нажатии на кнопку «Оплатить». Включает защищенные поля ввода платежных данных (данные обрабатывает Payture в соответствии со стандартами безопасности) и e-mail для отправки электронного чека в соответствии с требованиями 54-ФЗ. Платежный виджет оптимизирован для использования на мобильных устройствах и в различных браузерах.

Чтобы совершить пробный платеж, нажмите «Оплатить».

Оплатить

Чтобы протестировать работу виджета, используйте тестовые карты. Результат для этого виджета — всегда успешный платеж без 3DS.
Например, номер карты 4111 1111 1111 1111. Срок действия, CVC2/CVV2 и держатель — произвольные.
Высланный чек не является фискальным документом и служит только для демонстрации работы виджета.

Установка

Пример раздела head на странице с виджетом:

<head>
    <script type="text/javascript" src="path/to/widget/payture-widget.min.js" ></script>
    <link rel="stylesheet" type="text/css" href="path/to/widget/widgetStyles.css">
</head>

Пример вызова виджета при нажатии Оплатить:

<button id="start_widget" onclick="openWidget()">Оплатить</button>

Для установки виджета на сайт Продавцу необходимо выполнить следующие шаги:

1. Запросить в службе поддержки Payture параметры тестового доступа.
   
2. По умолчанию для виджета используются стандартные шаблоны Payture. Если Продавец желает изменить внешний вид шаблонов, необходимо подготовить и отправить в службу поддержки шаблон формы оплаты (Type=Pay) и шаблон с результатами операции (Type=Return), который открывается после 3DS-проверки. Продавец может как создать собственные шаблоны с нуля, так и изменить стандартные шаблоны для виджета Payture. Информацию, подробные технические сведения о создании шаблонов и примеры шаблонов для виджета вы можете получить здесь в разделе «Шаблоны для виджета Payture»;
3. Подключить на странице в разделе head библиотеку payture-widget.min.js. Скачать библиотеку payture-widget.min.js.
4. Добавить в разделе head необходимые стили для работы виджета. Скачать стили для виджета.
5. Задать функцию вызова виджета. Необходимые параметры задаются в конструкторе PaytureWidget().
6. Настроить открытие виджета на какое-либо событие, например, на нажатие кнопки «Оплатить».
7. При необходимости настроить поведение сайта в зависимости от аргумента success функции из OnTransactionCompleted.
8. Протестировать работу виджета на тестовой среде с использованием тестовых карт.
9. Получить от службы поддержки Payture параметры рабочего доступа и выполнить переключение в рабочую среду.

Параметры виджета

Пример функции вызова виджета:

function openWidget() {
    var widget = new PaytureWidget({
        Key : "Merchant_Widget",
        Amount : 20,
        Product : "Оплата заказа №1",
        Domain : 2,
        CustomParams : 
        {
            TemplateTag : "Default",
            Language : "Default",
            Name : "Иван Иванов",
            Delivery : "Самовывоз"
        },
        ChequeParams : 
        {  
            Positions:[  
               {  
                  Quantity: 1.000,
                  Price: 10.00,
                  Tax: 2,
                  Text: "Чай"
               },
               {  
                  Quantity : 2.000,
                  Price : 5.00,
                  Tax: 2,
                  Text: "Пирожок"
               }
            ],
            CustomerContact : "",
            Message: "Чек Payture"
        }, 
        OnTransactionCompleted : function(success) { 
            alert( success );  
            }
    });
}

Параметры виджета, которые передаются в его конструктор PaytureWidget():

SDK

Для облегчения интеграции платежного решения на сайт магазина вы можете использовать SDK.

В SDK можно найти готовые решения для разных языков программирования. По вопросам использования и встраивания в свои системы Вы можете обращаться в службу поддержки Payture.

	Node.js — готовый модуль для разработчиков на Node.js. Простая и удобная установка с помощью npm: npm install payture-official Добавить в проект: var payture = require('payture-official'); Дополнительная документация на GitHub
	CSharpPaytureAPI — готовая библиотека, доступная для скачивания с NuGet. Для установки удобно использовать менеджер NuGet из Visual Studio, либо устанавливаем через консоль NuGet по команде: Install-Package CSharpPaytureAPI Добавить в проект: using CSharpPayture; Дополнительная документация на GitHub
	Go — компилируемый многопоточный язык программирования, разработанный компанией Google. Добавить в проект: Go Get "github.com/Payture/Go-Payture-official/payture" Дополнительная документация на GitHub
	Готовое решение для разработчиков на Python. Установка: pip install payture Добавить в проект: import payture Дополнительная документация на GitHub

Готовые модули для CMS

Для облегчения интеграции платежного решения на сайт магазина вы можете использовать готовые платежные модули.

Мы не поддерживаем работу приложений сторонних разработчиков, все обновления вы можете посмотреть по ссылке для скачивания.

Разработчик	Описание	Установить
	1С-Битрикс — это автоматизированная система управления контентом. Продукт предназначен для создания и развития корпоративных проектов предприятий и организаций, информационных, новостных и справочных порталов, социальных сетей, интернет-магазинов и других видов сайтов.
	Битрикс24 — это популярная облачная платформа для управления бизнесом и коммуникаций внутри компании. Она предлагает широкий спектр инструментов для организации работы, включая управление задачами, проектами, клиентскими отношениями (CRM), внутренними коммуникациями и многим другим. Интеграция выполнена партнером. По вопросам поддержки обращаться к разработчику.
	Программный модуль для интернет-магазина на Simpla CMS. Simpla — это готовое решение для быстрого создания интернет-магазина с широкими возможностями и современным дизайном. Уже 63019 лицензионных установок.
	OpenCart — бесплатная система управления содержимым, ориентированная на создание интернет-магазинов. Программное обеспечение написано на языке программирования PHP, платформа устанавливается на любом веб-сервере с поддержкой PHP и MySQL. Данная CMS пригодится для тех, кому нужен легкий и надежный движок интернет-магазина. Большим преимуществом данной системы управления сайтом является визуальная привлекательность интерфейса.Инструкция по установке модуля
	Ubercart — это программный модуль с открытым исходным кодом, полностью интегрирующий интернет-магазин с CMS Drupal. Drupal — максимально функциональная система управления содержимым веб-сайта. Является свободным программным обеспечением, защищённым лицензией GPL, и развивается усилиями разработчиков со всего мира. Язык программирования - PHP, база данных - MySQL, PostgreSQL и другие. Подойдет для разработки веб-приложений любой сложности. Инструкция по установке модуля
	Commerce — это программный модуль с открытым исходным кодом, полностью интегрирующий интернет-магазин с CMS Drupal. Drupal — максимально функциональная система управления содержимым веб-сайта. Является свободным программным обеспечением, защищённым лицензией GPL, и развивается усилиями разработчиков со всего мира. Язык программирования - PHP, база данных - MySQL, PostgreSQL и другие. Подойдет для разработки веб-приложений любой сложности. Инструкция по установке модуля
	VirtueMart — это программный модуль с открытым исходным кодом, полностью интегрирующий интернет-магазин с CMS Joomla!. Joomla! — система управления содержимым сайта, написанная на языках PHP и JavaScript, использующая в качестве хранилища базы данных MySQL. Является свободным программным обеспечением, распространяемым под лицензией GNU GPL. CMS позволяет без особых знаний в веб-программировании создавать отличные и динамичные сайты. Инструкция по установке модуля
	Woocommerce — это программный модуль с открытым исходным кодом, полностью интегрирующий интернет-магазин с CMS WordPress. WordPress — система управления контентом с открытым исходным кодом, написанная на языке PHP. Универсальная и самая популярная CMS в мире. Применима к ресурсам любого назначения, от блогов до интернет-магазинов. Инструкция по установке модуля. Валюта оплаты по умолчанию RUB, для добавления других валют обратитесь в службу поддержки Payture
	Программный модуль для интернет-магазина ReadyScript. ReadyScript — собрала в себе все лучшее, что существует сегодня на рынке CMS, а также приобрела множество уникальных возможностей. Чтобы сохранить удобство пользования сайтом на различных по размеру экранах, сайт автоматически адаптируется, скрывая, сворачивая или переставляя некоторые второстепенные блоки. Все это включено в стандартную тему оформления.
	VirtualityCMS поможет Вам и вашим клиентам всегда быть рядом, получать актуальные предложения и повысить лояльность с помощью встроенных маркетинговых инструментов. В VirtualityCMS реализована система мультивалютности что позволяет загружать прайсы поставщиков в любых валютах, цены автоматически будут конвертированыв в основную вашу валюту. В админпанели цены будет указаны в валюте поставщика, а для клиентов на сайте в основной валюте. Для управления VirtualityCMS Вам не нужно сидеть в офисе или дома перед компьютером, Вы можете управлять вашим интернет-магазином, принимать заказы и платежи из любой точки мира, достаточно иметь мобильный гаджет и доступ в интернет. VirtualityCMS предоставляет вам все современные решения для успешного управления сайтом. Инструкция по установке модуля. Интеграция выполнена партнером. По вопросам поддержки обращаться к VirtualityCMS.
	Webasyst заменяет множество разрозненных сервисов и приложений и объединяет все бизнес-процессы компании в единой защищенной системе. Приложения Webasyst помогают решать все задачи развивающегося бизнеса — от приема заказов через маркетплейсы и анализа клиентской базы (CRM) до корпоративной базы знаний, поддержки клиентов и прогноза кассовых разрывов.

Pay сервисы

Программный интерфейс Payture позволяет клиентам оплачивать покупки в одно касание, используя карточные хранилища Apple Pay, Google Pay, Samsung Pay и SberPay.

Payture предлагает различные варианты подключения Apple Pay, Google Pay, Samsung Pay и SberPay. Интеграция возможна для всех интерфейсов: Payture API, Payture InPay и Payture eWallet, как при приеме платежей на странице оплаты Payture, так и на сайте или в мобильном приложении Продавца.

Интеграция

Apple Pay

Порядок интеграции Apple Pay различается в зависимости от используемого программного интерфейса Payture и канала приема платежей.

Инструкции:

• Регистрация Merchant ID и получение Payment Processing Certificate — необходимо для подключения Apple Pay на сайте или в приложении Продавца
• Верификация доменов и получение Merchant Identity Certificate — необходимо только для подключения Apple Pay на сайте Продавца

Google Pay

Порядок интеграции Google Pay различается в зависимости от используемого программного интерфейса Payture и канала приема платежей.

Samsung Pay

Необходимый параметр для интеграции Samsung Pay

• Public Key (выдается технической поддержкой компании Payture)

Yandex Pay

Порядок интеграции Yandex Pay различается в зависимости от используемого программного интерфейса Payture и канала приема платежей.

SberPay

SberPay позволяет оплачивать покупки в одно касание картами в приложении Сбербанк Онлайн

API

Программный интерфейс Payture позволяет клиентам оплачивать покупки в одно касание, используя карточные хранилища Apple Pay, Google Pay и Samsung Pay. Предоставляет Продавцу дополнительную возможность приема платежей по дебетовым и кредитным картам на сайте и в приложении.

Payture API

MobilePay

https://{Environment}.payture.com/api/MobilePay

Метод MobilePay используется для быстрого проведения клиентского платежа одним действием (одностадийный платеж) с помощью систем мобильных платежей Apple Pay, Google Pay, Samsung Pay.

Запрос

curl https://sandbox3.payture.com/api/MobilePay \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d PayToken={PayToken} \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
-d Checksum=true \
-d Amount=12515 \

В запросах наименования параметров чувствительны к регистру

Ответ

<Pay OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="True" Amount="12515"/>

<Pay OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="False" ErrCode="DUPLICATE_ORDER_ID"/>

<Pay OrderId="c3b33136-1180-643b-c159-6ee283970082" Key="Merchant" Success="3DS" Amount="12515" ACSUrl="{ACSUrl}" PaReq="{PaReq}" ThreeDSKey="{ThreeDSKey}" ThreeDSVersion="1.0"/>

XML строка с элементом Pay

MobileBlock

https://{Environment}.payture.com/api/MobileBlock

Метод MobileBlock позволяет блокировать денежные средства на карте Покупателя, добавленной в сервисах Apple Pay, Google Pay, Samsung Pay.

Запрос

curl https://sandbox3.payture.com/api/MobileBlock \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d Key=Merchant \
-d PayToken={PayToken} \
-d OrderId=c3b33136-1180-643b-c159-6ee283970082 \
-d Checksum=true \
-d Amount=12515 \

В запросах наименования параметров чувствительны к регистру