Повідомлення надсилається платіжним шлюзом до облікової системи торговця у випадку успішного чи не успішного виконання оплати клієнтом. Цей функціонал призначений для миттєвого отримання інформації про прийнятий платіж, не чекаючи надходження коштів на розрахунковий рахунок компанії. Повідомлення містить інформацію про кожен сплачений рахунок.

Успішна і гарантована переадресація браузера з параметрами результату оплати є необхідною умовою для отримання магазином факту оплати. Але у деяких випадках, це може погано спрацювати при різного роду ситуаціях, таких як:

1) Збій роботи браузера, зависання;
2) Некоректна поведінка користувача в момент передачі відповіді;
3) Пропажа з'єднання з інтернет-провайдером
4) Неправильна робота браузера при встановлених пакетах захисту, які можуть вносити зміни в роботу браузера.

Може статися ситуація, коли оплата карткою проведена, але магазину чи клієнту результат не доставлений. Для запобігання таких ризиків, всім торговим системам рекомендується впровадження функціоналу Notify_URL, який миттєво надсилає результат транзакції до налаштованого url торгової системи. Цей функціонал дозволяє автоматизувати роботу торгової системи і дає можливість не перевіряти кожну покупку через адміністративний інтерфейс вручну.

Доставка відповіді за адресою NOTIFY_URL

NOTIFY_URL це сторінка, доступна в інтернеті, для отримання повідомлень від платіжного шлюзу та подальшої відповіді шлюзу.

Для початку роботи з даною схемою необхідно в інтерфейсі адміністратора в розділі термінали прописати адресу, на яку будуть надсилатися повідомлення від платіжного шлюзу.

Цей url має бути доступним в інтернеті, у випадку використання будь-якого firewall(CloudFlare ets.), необхідно додати діапазон IP 195.85.198.1-256 платіжного шлюзу до white list.

Результати обробки

Результати обробки передаються методом HTTP / HTTPS POST з боку шлюзу на сторінку магазину (80/443 порти).

Сторінка Notify_URL має містити функціонал, який дозволить отримувати результати операцій від платіжного шлюзу та передавати необхідні параметри від інтернет-магазину при кожному переході клієнта на захищену платіжну сторінку.

Торгова система має повертати відповідь в тілі виконуваної сторінки. Кожен параметр і його значення у вигляді Параметр = Значення повертаються в новому рядку.

Рядки розділяються символом роздільника рядків \n.

У повідомленні від платіжного шлюзу, додатково до оригінального набору параметрів (MID, TID, OrderID, Currency, TotalAmount, XID, PurchaseTime), повертається ще 3 нових параметри, по яким торгова система потім надає відповідь платіжному шлюзу:

Параметр	Значение	Описание
Response.action	approve \| reverse	При значенні 'approve' торгова система дає схвалення для подальшого успішного завершення покупки. При відповіді 'reverse' торгова система не погоджує завершення операції з якихось причин(товару немає в наявності) та шлюз процесує відмову клієнту по транзакції. Після чого, встановлюється ознака неуспішного завершення покупки з кодом 503 - «Транзакція скасована магазином»
Response.reason	An.. 255	Пояснення відповіді магазину (опціонально), наприклад - причина для значення Response.action
Response.forwardUrl	An.. 255	Значення URL для редіректу браузера користувача, замість SUCCESS_URL або FAILURE_URL (надає можливість використовувати динамічні посилання)

Приклад :

echo "MerchantID="1752493"\n";

echo "TerminalID="E7880293"\n";

echo "OrderID="ID0009992"\n";

echo "Currency="980"\n";

echo "TotalAmount="980"\n";

echo "XID="333333-4444444"\n";

echo "PurchaseTime="090929152500"\n";

echo Response.action=”approve”\n”;

echo "Response.reason="\n";

echo "Response.forwardUrl="\n";

У адміністратора магазину є вибір дозволяти транзакції, за якими не проходить отримання повідомлення по NOTIFY_URL, або заборонити їх. Дана схема дозволяє автоматизованим системам обліку наданих послуг, які використовують інформацію від платіжного шлюзу, уникнути невідповідності даних в разі неотримання повідомлення по NOTIFY_URL. Налаштувати це можна у адміністративному інтерфейсі окремо.

IP адреси відправлення повідомлень

TEST 18.196.61.127

3.120.143.246

18.197.170.36

Тестове середовище

PROD 195.85.198.16

Робоче середовище

Приклад працюючого функціоналу :

<?php
	$MerchantID = $post['MerchantID'];
	$TerminalID = $post['TerminalID'];
	$OrderID = $post['OrderID'];
	$Delay = $post['Delay'];
	$PurchaseTime = $post['PurchaseTime'];
	$TotalAmount = $post['TotalAmount'];
	$AltTotalAmount = $post["AltTotalAmount"];
	$CurrencyID = $post['Currency'];
	$AltCurrencyID = $post['AltCurrency'];
	$XID = $post['XID'];
	$SD = $post['SD'];
	$TranCode = $post['TranCode'];
	$ApprovalCode = $post['ApprovalCode'];
	$signature = $post["Signature"];
	
	$signature = base64_decode($signature);
	
	$data = "$MerchantID;$TerminalID;$PurchaseTime;$OrderID;$CurrencyID;$TotalAmount;$SD;";
	
	$data = $MerchantID . ";" . $TerminalID . ";" . $PurchaseTime . ";" . $OrderID . ";" . $XID . ";" . $CurrencyID . ";" . $TotalAmount . ";" . $SD . ";" . $TranCode . ";" . $ApprovalCode . ";";
	
	
	$crtid = openssl_pkey_get_public(file_get_contents(dirname(__FILE__) . "/cert/test-server.cert"));
	
	$verify_status = openssl_verify($data, $signature, $crtid);
	openssl_free_key($crtid);
	
	if ($verify_status == 1) {
		echo "MerchantID = " . $MerchantID . "\n";
		echo "TerminalID = " . $TerminalID . "\n";
		echo "OrderID = " . $OrderID . "\n";
		echo "Delay = " . $Delay . "\n";
		echo "Currency = " . $CurrencyID . "\n";
		echo "TotalAmount = " . $TotalAmount . "\n";
		echo "XID = " . $XID . "\n";
		echo "PurchaseTime = " . $PurchaseTime . "\n";
		echo "Response.action= approve \n";
		echo "Response.reason= ok \n";
		echo "Response.forwardUrl=  \n";
	} else {
		echo "MerchantID = " . $MerchantID . "\n";
		echo "TerminalID = " . $TerminalID . "\n";
		echo "OrderID = " . $OrderID . "\n";
		echo "Delay = " . $Delay . "\n";
		echo "Currency =  " . $CurrencyID . "\n";
		echo "TotalAmount = " . $TotalAmount . "\n";
		echo "XID = " . $XID . "\n";
		echo "PurchaseTime = " . $PurchaseTime . "\n";
		echo "Response.action= reverse \n";
		echo "Response.reason= something goes wrong \n";
		echo "Response.forwardUrl=  \n";
	}
?>

Результат:

Notify request message:

Direct Notification 
URL=https://dev.cccbank.com/store/payment_gateway/aval/confirm_payment (url з функціоналом)
                  
Notify Request 	(запит від шлюзу)

Notify request message: 
Email = ''
TranCode = '000'
MerchantID = '1757161'
TotalAmount = '3749'
OrderID = '1927'
ApprovalCode = '748063'
ProxyPan = '499999******0011'
Rrn = '306219798564'
PurchaseTime = '230303194857'
SD = ''
XID = '23030319-718559'
WalletType = 'APPLE_PAY'
Currency = '980'
Signature = 'GcTwytr+RM1rwxTi7jb83h87BnSxWnb8FuzgarjUPZy7cNx1Qm25b8W7PInD0RjqbrbEVgFk+RxSqp69d1TSZGUxQ='
TerminalID = 'E7885001'

             
     
Notify Response (відповідь торгової системи)

Response parsing result: 
RESPONSE.ACTION=approve
RESPONSE.REASON=ok
RESPONSE.FORWARDURL=

                  

Notify result (результат)

Notified : true
                  
Forward to success page (редірект на сторінку після успішної оплати)

[toSuccessMerchant]
Forward URL : https://dev.сссcbank.com/store/payment_gateway/aval/success_payment

Перелік параметрів, які надсилаються від платіжного шлюзу до інтернет-магазину:

Параметр	Формат	Назва параметра	Комментар
MerchantID	an15	Ідентифікатор торговця	Збігається з даними в запиті авторизації
TerminalID	an8	Ідентифікатор терміналу	Збігається з даними в запиті авторизації
TotalAmount	n..12	Сума замовлення	Збігається з даними в запиті авторизації
AltTotalAmount	n..12	Сума замовлення (альтернативна валюта)	Збігається з даними в запиті авторизації
Currency	n3	Валюта	Збігається з даними в запиті авторизації
AltCurrency	n3	Альтернативна валюта	Збігається з даними в запиті авторизації
PurchaseTime	N12	Час запиту угоди (YYYYMMDDhhmmss)	Збігається з даними в запиті авторизації
OrderID	ans..20	Order ID	Збігається з даними в запиті авторизації
XID	ans28	Ідентифікатор транзакції (номер замовлення, доповнений до 20 символів)	Збігається з даними в запиті авторизації
WalletType	APPLE_PAY \| GOOGLE_PAY	Тип гаманця	Для включення цього параметру в Notify Request зверніться, будь ласка, за поштою ec@upc.ua
SD	an... 99	Дані сесії	Збігається з даними в запиті авторизації
ApprovalCode	An6	Код авторизації хоста	Код авторизації
Rrn	N12	Retrieval Reference Number	Унікальний номер транзакції в системі авторизації і розрахунків обслуговуючого банку
ProxyPan	N13…19	4 последние цифры номера карты.	Значение PAN ( 4 последние цифры ) с дополненными нулями впереди для индикации длины PAN.
TranCode	N3	Код завершення транзакції	Див. табл. 3
Signature	An…40	Значення MAC-коду для обраної схеми взаємодії шлюзу-магазин	Довжина параметра залежить від обраної схеми обчислення MAC-коду
Delay	N1	Ідентифікатор платежу Преавторізація	Збігається з даними в запиті авторизації

У разі якщо з якихось причин схема отримання відповіді з боку шлюзу не відпрацьована - транзакція буде автоматично скасовано.

В даному випадку оригінальна транзакція має тип операції покупка і код транзакції

504 / Даний запит на оплату не дозволено платіжним шлюзом, відкат зроблений в автоматичному режимі платіжним сервером має код транзакції
000 / Транзакція завершена успішно

Далі представлена логіка отримання відповіді з боку шлюзу (рис.1).

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

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

Браузер не поддерживается