5.1. Алгоритм выполнение операции Card-To-Account (P2PDebit) по картам платежной системы PROSTIR [SP2]
Здесь находится описание алгоритма выполнение операции Card-To-Account (P2PDebit) по картам платежной системы PROSTIR при использовании платежного портала Процессингового центра "Прокард"
Сервер сервис-провайдера отправляет административный POST-запрос по адресу PayURL о регистрации заказа на
C2A - Card-To-Account (административная операция CreateOrder для C2A), со значением в поле Amount=0. Примечание: При указании в поле Amount значения отличного от 0, в кабинете будет неверно отображаться сумма заказа.
В ответ сервер сервис-провайдера получает уникальный номер заказа, идентификатор сессии и интернет адрес.
После сервер сервис-провайдера формирует административный запрос на P2PDebit с использованием специальных наборов параметров для платежной системы PROSTIR.
При необходимости (в случае сбоев или возникновения других нештатных ситуаций) сервер сервис-провайдера может инициировать запрос о статусе оплаты заказа (административная операция GetOrderStatus) или информации о заказе (административная операция GetOrderInformation).
Реверс операции можно выполнить при помощи административной операции (Reversal).
1. Административная операция CreateOrder для C2A - Card-To-Account по картам платежной системы PROSTIR
XML-запрос имеет формат
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>CreateOrder</Operation>
<Language></Language>
<Order>
<OrderType>C2A</OrderType>
<Merchant>TEST_C2A</Merchant>
<Amount>0</Amount>
<Currency>980</Currency>
<Description>Тестовый перевод</Description>
<email></email>
<phone></phone>
<ApproveURL></ApproveURL>
<DeclineURL></DeclineURL>
<CancelURL></CancelURL>
<Fee></Fee>
<AddParams>
<SenderName>TEST TEST</SenderName>
<ResidentCityInLatin>DNIPRO</ResidentCityInLatin>
<ResidentCountry>804</ResidentCountry>
<SenderPostalCode>49000</SenderPostalCode>
<Address>12, Ulichnaya str</Address>
</AddParams>
</Order>
</Request>
</TKKPG>Описание параметров запроса
Параметр | Обяз. поле | Описание |
|---|---|---|
Language | Да | Язык интерфейса. Заполняется в соответствии с RFC 1766 двухсимвольным кодом языка (например, RU – русский, EN – английский, UK – украинский и т. д.) |
OrderType | Да | Тип заказа. Параметр определяет финансовую транзакцию, которая будет впоследствии сформирована. Для выполнения операции Card 2 Account, следует указать значение C2A |
Merchant | Да | Идентификатор интернет-магазина. |
Amount | Да | Сумма транзакции в копейках |
Currency | Да | Код валюты транзакции (980-гривня) |
Description | Да | Текстовое описание заказа – будет отображено для клиента при выполнении платежа на странице оплаты. |
Нет | E-mail клиента (дополнительный параметр), который можно сохранить в БД. | |
phone | Нет | Номер телефона клиента (дополнительный параметр), который можно сохранить в БД. |
ApproveURL | Нет | URL для перенаправления в случае успешной операции (APPROVE). |
DeclineURL | Нет | URL для перенаправления в случае отказа (DECLINE). |
CancelURL | Нет | URL для перенаправления в случае отмены (CANCEL). |
AddParams | Да | Доп. Поля для идентификации при переводах. |
Список дополнительных полей для C2A по картам платежной системы PROSTIR
Параметр | Обяз. поле | Описание |
|---|---|---|
SenderName | Да | Полное имя/имя на карте отправителя (латинские символы) |
ResidentCityInLatin | Да | Город резидентства отправителя (латинские символы) |
ResidentCountry | Да | Числовой код страны резидентства отправителя по ISO 3166-1 Numeric |
SenderPostalCode | Да | Почтовый индекс отправителя |
Address | Да | Адрес отправителя |
Примечание:
Список обязательных полей может изменяться по требованию платежной системы PROSTIR.
2. Административная операция P2PDebit по картам платежной системы PROSTIR
XML-запрос имеет формат
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>P2PDebit</Operation>
<Order>
<Merchant></Merchant>
<OrderID></OrderID>
</Order>
<SessionID></SessionID>
<Amount></Amount>
<Currency></Currency>
<Account></Account>
<PAN></PAN>
<ExpDate></ExpDate>
<CVV2></CVV2>
<CAVV></CAVV>
<eci></eci>
<IP></IP>
<PAN2></PAN2>
<Account2></Account2>
<Fee></Fee>
<OrigAmount></OrigAmount>
<OrigCurrency></OrigCurrency>
</Request>
</TKKPG>Описание параметров запроса
Название параметра | Обяз. поле | Описание |
|---|---|---|
Merchant | Да | Идентификатор интернет-магазина. |
OrderID | Да | Идентификатор заказа, по которому необходимо получить информацию |
SessionId | Да | Идентификатор сессии, который был выдан ранее для данного заказа с соответствующим OrderID |
Amount | Да | Сумма транзакции заказа |
Currency | Да | Код валюты транзакции (980) |
Account | Да | Номер целевой карты/счета отправителя |
PAN | Да | Номер карты |
ExpDate | Да | Срок действия карты в формате YYMM. |
CVV2 | Да | CVV2 карты |
CAVV | Нет | CAVV по 3-D Secure транзакции. |
eci | Нет | Код TWEC-индикатора. По картам PROSTIR, значение должно быть установлено = 82. |
IP | Да | IP клиента |
PAN2 | Нет | Номер карты получателя |
Account2 | Да | Номер целевой карты/счета получателя |
Fee | Нет | Комиссия. Amount НЕ включает в себя fee. |
OrigAmount | Нет | Oригинальная сумма операции |
OrigCurrency | Нет | Оригинальная валюта операции |
Пример XML-запроса
<?xml version="1.0" encoding="UTF-8"?>
<TKKPG>
<Request>
<Operation>P2PDebit</Operation>
<Order>
<Merchant>TEST_C2A</Merchant>
<OrderID>828</OrderID>
</Order>
<SessionID>ECDE79578768ECFBF2897A0F44CC0CEF</SessionID>
<Amount>10000</Amount>
<Currency>980</Currency>
<Account></Account>
<PAN>555555******5555</PAN>
<ExpDate>2001</ExpDate>
<CVV2>123</CVV2>
<CAVV></CAVV>
<eci>82</eci>
<IP></IP>
<PAN2></PAN2>
<Account2>UA083073500000026004001008001</Account2>
<Fee></Fee>
<OrigAmount></OrigAmount>
<OrigCurrency></OrigCurrency>
</Request>
</TKKPG>Пример ответа
Описание параметров ответа
Название параметра | Обяз. поле | Описание |
|---|---|---|
ResponseCode | Да | Результат выполнения запроса: Подробнее в Приложение. Возвращаемые коды авторизации |
Copyright © 2015-2021 PROCARD