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

Да

Текстовое описание заказа – будет отображено для клиента при выполнении платежа на странице оплаты.

email

Нет

E-mail клиента (дополнительный параметр), который можно сохранить в БД.

phone

Нет

Номер телефона клиента (дополнительный параметр), который можно сохранить в БД.

ApproveURL

Нет

URL для перенаправления в случае успешной операции (APPROVE).

DeclineURL

Нет

URL для перенаправления в случае отказа (DECLINE).

CancelURL

Нет

URL для перенаправления в случае отмены (CANCEL).

MITAttributes

Да

Признаки транзакции, инициированной с вводом карточных данных (или их аналога), для операций с использованием токена использовать значение = 1.

DSRPFlag

Да

Признак транзакции, инициированной с помощью мобильного приложения (технология DSRP). Возможные значения:

  • 0 (по умолчанию) – транзакция инициирована без использования технологии DSRP;

  • 1 (использовать для операции по токену) – транзакция инициирована с использованием технологии 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 – не увеличивать сумму заказа

 Примечание:

  1. Для первой финансовой операции (Purchase) по токену MasterCard указывается eci=82, в последующих операциях указывать eci=62 и CAVV заполняется значением из TokenCryptogram исходной операции.

  2. Для первой финансовой операции (Purchase) по токену Visa указывается eci=87, в последующих операциях указывать eci=62 и CAVV заполняется значением из TokenCryptogram исходной операции.


Связанные страницы:

There are no items with the selected labels at this time.

Copyright © 2015-2021 PROCARD