5.2. Выполнение платежа по токену MasterCard / Visa с признаком «Рекуррентный» [SP2]
Здесь находится описание алгоритма выполнения платежа по токену MasterCard / Visa с признаком «Рекуррентный» при использовании платежного портала Процессингового центра "Прокард"
1. Сервер сервис-провайдера отправляет административный POST-запрос по адресу PayURL о регистрации заказа на покупку (административная операция CreateOrder для Purchase), со значением в поле Amount=0.
Примечание:
При указании в поле Amount значения отличного от 0, в кабинете будет неверно отображаться сумма заказа.
Также в административной операции CreateOrder, в блок Order необходимо добавить параметры:
AddParams → MITAttributes = 1.
AddParams → DSRPFlag = 1.
AddParams → MasterPassWalletId = ХХХ
AddParams → Purchase.Recur.frequency = 0 или 1.
AddParams → Purchase.Recur.endRecur = 20221231.
(Дата, после которой выполнение периодических платежей / переводов будет невозможно, формат YYYYMMDD)
2. В ответ сервер сервис-провайдера получает уникальный номер заказа, идентификатор сессии и интернет адрес.
3. Сервер сервис-провайдера формирует административный запрос на Purchase с использованием специальных наборов параметров (административная операция Purchase).
4. При необходимости (в случае сбоев или возникновения других нештатных ситуаций) сервер сервис-провайдера может инициировать запрос о статусе оплаты заказа (административная операция GetOrderStatus) или информации о заказе (административная операция GetOrderInformation).
5. Для инициирования возврата средств, сервер сервис-провайдера может инициировать операцию Refund.
1. Административная операция CreateOrder для Recurring с использованием токена MasterCard / Visa
XML-запрос имеет формат
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>CreateOrder</Operation>
<Language></Language>
<Order>
<OrderType>Purchase</OrderType>
<Merchant></Merchant>
<Amount></Amount>
<Currency></Currency>
<Description></Description>
<email></email>
<phone></phone>
<ApproveURL></ApproveURL>
<DeclineURL></DeclineURL>
<CancelURL></CancelURL>
<Fee></Fee>
<AddParams>
<MITAttributes>1</MITAttributes>
<DSRPFlag>1</DSRPFlag>
<MasterPassWalletId>XXX</MasterPassWalletId>
<Purchase.Recur.frequency></Purchase.Recur.frequency>
<Purchase.Recur.endRecur>20221231</Purchase.Recur.endRecur>
</AddParams>
</Order>
</Request>
</TKKPG>
Описание параметров запроса
Параметр | Обяз. поле | Описание |
---|---|---|
Language | Да | Язык интерфейса. Заполняется в соответствии с RFC 1766 двухсимвольным кодом языка (например, RU – русский, EN – английский, UK – украинский и т. д.) |
OrderType | Да | Тип заказа. Параметр определяет финансовую транзакцию, которая будет впоследствии сформирована. Для выполнения покупки следует указать значение Purchase |
Merchant | Да | Идентификатор интернет-магазина. |
Amount | Да | Сумма транзакции в копейках |
Currency | Да | Код валюты транзакции (980-гривня) |
Description | Да | Текстовое описание заказа – будет отображено для клиента при выполнении платежа на странице оплаты. |
Нет | E-mail клиента (дополнительный параметр), который можно сохранить в БД. | |
phone | Нет | Номер телефона клиента (дополнительный параметр), который можно сохранить в БД. |
ApproveURL | Нет | URL для перенаправления в случае успешной операции (APPROVE). |
DeclineURL | Нет | URL для перенаправления в случае отказа (DECLINE). |
CancelURL | Нет | URL для перенаправления в случае отмены (CANCEL). |
MITAttributes | Да | Признаки транзакции, инициированной с вводом карточных данных (или их аналога), для операций с использованием токена использовать значение = 1. |
DSRPFlag | Да | Признак транзакции, инициированной с помощью мобильного приложения (технология DSRP). Возможные значения:
|
MasterPassWalletId | Да | Идентификатор электронного кошелька. |
Purchase.Recur.frequency | Да | Минимальное количество дней между периодическими платежами / переводами. Формат параметра – число длиной 1-4 символа. Примечание: Если не требуется ограничивать частоту допускается значение = 0. |
Purchase.Recur.endRecur | Да | Дата, после которой выполнение периодических платежей / переводов будет невозможно. Формат параметра – YYYYMMDD. |
2. Административная операция Purchase для Recurring с использованием токена MasterCard / Visa
При вызове административной операции Purchase установить значение поля eci в:
eci = 61
XML-запрос имеет формат
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>Purchase</Operation>
<Order>
<Merchant></Merchant>
<OrderID></OrderID>
</Order>
<SessionID></SessionID>
<Amount>1000</Amount>
<Currency>980</Currency>
<PAN>****************</PAN>
<CardUID></CardUID>
<ExpDate>2212</ExpDate>
<CVV2>123</CVV2>
<CAVV></CAVV>
<eci></eci>
<IP></IP>
<isMOTO></isMOTO>
<IncreaseOrderAmount></IncreaseOrderAmount>
</Request>
</TKKPG>
Описание параметров запроса
Параметр | Обяз. поле | Описание |
---|---|---|
Merchant | Да | Идентификатор интернет-магазина. |
OrderID | Да | Идентификатор заказа, по которому необходимо получить информацию |
SessionId | Да | Идентификатор сессии, который был выдан ранее для данного заказа с соответствующим OrderID |
Amount | Да | Сумма транзакции заказа |
Currency | Да | Код валюты транзакции (980) |
PAN | Да | Номер карты |
ExpDate | Да | Срок действия карты в формате YYMM. |
CVV2 | Да | CVV2 карты |
CAVV | Нет | CAVV по 3-D Secure транзакции. |
eci | Да | Код TWEC-индикатора. В случае, когда проверка на 3DSecure произведена успешно (PARes status = Y), должно быть установлено в значение 82, иначе в значение 81. Другие значения данного поля индивидуальны. |
IP | Нет | IP клиента |
isMOTO | Нет | Выполнение транзакции с кодом 03 (заказ по почте или по телефону). Возможные значения: true – будет выполнена MOTO-транзакция false (по умолчанию) – будет выполнена транзакция с кодом 00 (продажа) |
TokenCryptogram | Нет | TAVV/DTVV/DSRP криптограмма, которая используется при проведении 3-D Secure аутентификации для транзакций, выполняемых по токену. |
IncreaseOrderAmount | Нет | Признак увеличения суммы заказа на величину параметра Amount операции покупки. Возможные значения: true (по умолчанию) – увеличивать сумму заказа на сумму покупки false – не увеличивать сумму заказа |
Примечание:
Для первой финансовой операции (Purchase) по токену MasterCard указывается eci=82, в последующих операциях указывать eci=62 и CAVV заполняется значением из TokenCryptogram исходной операции.
Для первой финансовой операции (Purchase) по токену Visa указывается eci=87, в последующих операциях указывать eci=62 и CAVV заполняется значением из TokenCryptogram исходной операции.
Copyright © 2015-2021 PROCARD