API

  1. Домой
  2. API
  3. Оповещение о проведении клиринга

Оповещение о проведении клиринга

Если магазин настроен на проведение транзакций по банковским картам в две стадии – авторизация и клиринг, — Platron оповещает магазин об исполнении клиринга сразу после отправки соответствующей команды в банк.

Обычно клиринг выполняется по инициативе магазина, когда магазин дает Platron команду на клиринг (см. раздел Запрос на клиринг транзакций по банковским картам), однако если магазин не дал эту команду в течение срока, указанного в настройках магазина (не более 5 дней), после авторизации, Platron самостоятельно отправляет команду на клиринг в банк.

Для оповещения магазина о клиринге Platron вызывает скрипт магазина Capture URL с помощью метода Request Method. Platron передает информацию о номере заказа и ожидает ответа в течение 30 секунд. Если сервер продавца недоступен в момент вызова Capture URL (нет ответа более 30 секунд) или его ответ не удалось интерпретировать, Platron будет предпринимать повторные попытки его вызвать в течение 2 часов.

Параметры вызова Capture URL:

Параметр Описание
pg_order_id Идентификатор платежа в системе продавца
pg_payment_id Внутренний идентификатор платежа в системе Platron
Параметры продавца Все поля, переданные с веб-сайта продавца, не имеющие префикса «pg_»
pg_salt Случайная строка
pg_sig подпись

Пример GET вызова магазина гейтом:

http://store.ru/onCapture.php?pg_salt=gw41b38vc&pg_order_id=2614&pg_payment_id=825941&pg_sig=afaef9d237932f57bd05c602d287df34&uservar1=45363456

Пример xml вызова (POST с XML в параметре pg_xml) магазина гейтом:

<?xml version="1.0" encoding="utf-8"?>
  <request>
	<pg_salt>gw41b38vc</pg_salt>
	<pg_order_id>2614</pg_order_id>
	<pg_payment_id>825941</pg_payment_id>
	<uservar1>45363456</uservar1>
	<pg_sig>afaef9d237932f57bd05c602d287df34</pg_sig>
  </request>

Получив сообщение об отмене платежа, магазин должен ответить с указанием статуса ok.

<?xml version="1.0" encoding="utf-8"?>
  <response>
	<pg_salt>eyhfh42za22h</pg_salt>
	<pg_status>ok</pg_status>
	<pg_sig>ea362f52d23770986bd05c6fc5f9427d</pg_sig>
</response>

Список параметров ответа магазина:

Параметр Описание
pg_status ok – информация принята
error – ошибка в интерпретации данных
pg_error_description Описание ошибки, в случае pg_status=error
pg_salt Случайная строка
pg_sig Подпись