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=c8cc6c5c-30da-d7e1-e090-46f25ae30626 \

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

Запрос может быть отправлен 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=4111111111100031; \
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=4111111111100031;
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="00a94d92-1d84-44be-fa32-1c9591443347"/>