| Tip |
|---|
Здесь находится описание алгоритма выполнение операции Card-To-Account (P2PDebit) по картам платежной системы PROSTIR при использовании платежного портала Процессингового центра "Прокард" |
Сервер сервис-провайдера отправляет административный POST-запрос по адресу PayURL о регистрации заказа на
C2A - Card-To-Account (административная операция CreateOrder для C2A), со значением в поле Amount=0. Примечание: При указании в поле Amount значения отличного от 0, в кабинете будет неверно отображаться сумма заказа.
В ответ сервер сервис-провайдера получает уникальный номер заказа, идентификатор сессии и интернет адрес.
После сервер сервис-провайдера формирует административный запрос на P2PDebit с использованием специальных наборов параметров для платежной системы PROSTIR.
При необходимости (в случае сбоев или возникновения других нештатных ситуаций) сервер сервис-провайдера может инициировать запрос о статусе оплаты заказа (административная операция GetOrderStatus) или информации о заказе (административная операция GetOrderInformation).
Реверс операции можно выполнить при помощи административной операции (Reversal).
На этой странице:
| Table of Contents |
|---|
1. Административная операция CreateOrder для C2A - Card-To-Account по картам платежной системы PROSTIR
XML-запрос имеет формат
| Code Block | ||
|---|---|---|
| ||
<?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-запрос имеет формат
| Code Block | ||
|---|---|---|
| ||
<?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-запроса
| Code Block | ||
|---|---|---|
| ||
<?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> |
Пример ответа
| Code Block |
|---|
<?xml version="1.0" encoding="UTF-8"?> <out> <l name="ResponseCode" value="001"/> <f name="F" value="322829 A"/> <f name="J" value="999986559415"/> <f name="R" value="D"/> <f name="a" value="&C810#&R01#"/> <f name="h" value="0010010730"/> <f name="t" value="295629"/> </out> |
Описание параметров ответа
Название параметра | Обяз. поле | Описание |
|---|---|---|
ResponseCode | Да | Результат выполнения запроса: Подробнее в Приложение. Возвращаемые коды авторизации |
| Filter by label (Content by label) | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|