Повернення / скасування транзакції

Запит повернення / реверсала можливо здійснити тільки на операцію авторизації. Для виконання повернення магазин зі свого боку повинен відправити запит на шлюз.

Це може бути зроблено передачею POST запиту на сторінку шлюзу з параметрами які наведені в таблиці:

Параметр	Структура	Формат	Назва параметра	Комментар
MerchantID	L	an15	Ідентифікатор торговця
TerminalID	F	an8	Ідентифікатор терміналу
TotalAmount	F	N1..12	Сума заказу	У дрібних одиницях валюти (копійки, центи)
Currency	F	n3	Валюта
PurchaseTime	F	n12..17	Час запиту в форматі yyMMddHHmmss або yyMMddHHmmssZ
OrderID	L	Ans…20	Номер замовлення довжиною до 20 байт
ApprovalCode	F	An6	Код авторизації хоста	Код авторизації
Rrn	F	n12	Retrieval Reference Number	Унікальний номер транзакції в системі авторизації і розрахунків обслуговуючого банку
SD (O)	Var	an...99	Session Data -Дані сесії	Допоміжний параметр, може бути використаний торговельною системою для управління призначеними для користувача сесіями
Signature	Var	Залежить від схеми	Значення MAC-коду або підпису	Довжина параметра залежить від обраної схеми обчислення
Ref3 (O)	L	ans..1 150

Шлюз формує відповідь у вигляді текстової сторінки з параметрами представлені в таблиці:

Параметр	Формат	Назва параметра	Коментар
TranCode	N3	Код завершення транзакції	Див. табл. 3
MerchantID	an15	Ідентифікатор торговця
TerminalID	an8	Ідентифікатор терміналу
CardType	an4	Належність карти	VISA – Visa MAST – MasterCard MAES - Maestro
ERROR (0)	ans	Містить коротку інформацію про помилку	Опціонально і формується тільки при виникненні помилки в процесі обробки запиту

Зверніть увагу

Повернення / реверсал вважається успішним, якщо значення поля TranCode = 000.

Запит

<html>
<body>
<form method='POST' action="https://ecg.test.upc.ua/go/repayment">
  <input type='hidden' name='MerchantID' value='1752493' />
  <input type='hidden' name='TerminalID' value=' E7880293' />
  <input type='hidden' name='OrderID' value='PAY160601124534' />
  <input type='hidden' name='Currency' value='980' />
  <input type='hidden' name='TotalAmount' value='12550' />
  <input type='hidden' name='PurchaseTime' value='160601124534' />
  <input type='hidden' name='ApprovalCode' value='123456' />
  <input type='hidden' name='RRN' value='2222222222' />
  <input type='hidden' name='RefundAmount' value='12000' />
  <input type='hidden' name='Signature' value='45F345Fafde4455445Gvb550' />
  <input type='submit' value='go'> 
 </form>
</body>
</html>

Відповідь

<html>
  <body>
	<form>
    <input name="MerchantID" type="hidden" value="1758888"/> 
    <input name="TerminalID" type="hidden" value="E7887777"/> 
    <input name="CardScheme" type="hidden" value="VISA" />
    <input name="TranCode" type="hidden" value="000" />
	</form>
  </body>
</html>

Формування підпису Signature

Детальна інструкція по формуванню підпису Signature в запитах - Формування підпису.