2. В ответ сервер сервис-провайдера получает уникальный номер заказа, идентификатор сессии и интернет адрес.
3. Сервер сервис-провайдера формирует административный запрос на Purchase с использованием специальных наборов параметров (административная операция Purchase).
4. При необходимости (в случае сбоев или возникновения других нештатных ситуаций) сервер сервис-провайдера может инициировать запрос о статусе оплаты заказа (административная операция GetOrderStatus) или информации о заказе (административная операция GetOrderInformation).
5. Для инициирования возврата средств, сервер сервис-провайдера может инициировать операцию Refund.
1. Административная операция CreateOrder для Recurring с использованием токена MasterCard / Visa
XML-запрос имеет формат
:Code Block | ||
---|---|---|
| ||
<?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-запрос имеет формат
:Code Block | ||
---|---|---|
| ||
<?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 исходной операции.
Filter by label (Content by label) | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|