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=00a94d92-1d84-44be-fa32-1c9591443347; \
Amount=101" \В запросах наименования параметров чувствительны к регистру
| Параметр | Описание | Формат |
|---|---|---|
| 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 |
| Amount | Заблокированная сумма на карте Покупателя в копейках | Integer Mandatory |
| Amount | Заблокированная сумма на карте Покупателя в копейках | Integer Mandatory |
Пример параметра DATA (decoded):
VWUserLgn=123@ya.ru;
VWUserPsw=2645363;
CardId=00a94d92-1d84-44be-fa32-1c9591443347;
Amount=12480Ответ
XML строка с элементом Activate
Примеры ответов
<Activate Success="True" VWUserLgn="123@ya.ru" CardId="00a94d92-1d84-44be-fa32-1c9591443347"/>| Параметр | Описание | Формат |
|---|---|---|
| Success | Признак успешности операции. Принимает значения:True — операция успешнаFalse — операция неуспешна | String Mandatory |
| VWUserLgn | Идентификатор Покупателя в системе Payture Соответствует переданному в запросе | String [1..50] Mandatory |
| CardId | Идентификатор карты в системе Payture Передается, если «Success=True» | String [36] Optional |
| ErrCode | Код ошибки. См. коды ошибок Передается, если «Success=False» | String Optional |
AddSubmit3DS
Команда AddSubmit3DS используется для завершения добавления карты, защищенной 3-D Secure. Выполняется после запроса Add — на стороне Продавца и получения результатов 3‑D Secure аутентификации от банка-эмитента.
Remove
Команда для удаления данных платежной карты (как активированной, так и неактивированной) из списка карт Покупателя.
