API

  1. Home
  2. API
  3. Вспомогательные запросы
  4. Запрос на клиринг транзакций

Запрос на клиринг транзакций

Магазин может самостоятельно запрашивать клиринг у банка через Platron, если в банке настроено проведение платежей в два шага – авторизация и клиринг.

В случае соответствующей настройки системы, после проведения транзакции, транзакция будет авторизована, но не рассчитана. Время максимальной задержки списания равно 5 дней и может регулироваться на стороне Platron от 1 до 5 дней.

Магазин делает запрос на https://www.platron.ru/do_capture.php, параметры передаются одним из методов прямого запроса (см. Способы прямого взаимодействия между магазином и Platron). Максимальное время ожидания ответа – 30 секунд.

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

pg_merchant_id Идентификатор магазина
pg_payment_id Идентификатор платежа
pg_long_record Длинная запись, см. дополнительной документации.
Ее можно получить у сотрудников технического отдела.
pg_amount Сумма клиринга. Может быть меньше или равно суммы авторизации.
*При сумме меньше суммы авторизации, создается возврат на разницу.
pg_salt Случайная строка
pg_sig Подпись

Пример GET запроса:

https://www.platron.ru/do_capture.php?pg_salt=123&pg_merchant_id=456&pg_payment_id=1234567&pamp;g_sig=7f3af9d237952f56bd05c602d2879a3c

Пример XML запроса (передается POST’ом в параметре pg_xml):

<?xml version="1.0" encoding="utf-8"?>
  <request>
	<pg_salt>123</pg_salt>
	<pg_merchant_id>456</pg_merchant_id>
	<pg_payment_id>1234567</pg_payment_id>
	<pg_sig>7f3af9d237952f56bd05c602d2879a3c</pg_sig>
  </request>

Ответ на запрос представляет собой XML вида:

<response>
<pg_salt>1111</pg_salt>
<pg_status>ok</pg_status>
<pg_clearing_refund_id>449312</pg_clearing_refund_id>
<pg_sig>c38ebf6a6b7f5e30316bc984dc69ce37</pg_sig>
</response>

Здесь:

pg_status Результат обработки запроса.
ok если запрос принят на обработку. По результату будет вызван Capture URL магазина.
error в любом другом случае.
pg_error_description Описание ошибки в случае pg_status=error
pg_clearing_refund_id Id возвратной операции при клиринге на сумму, меньше чем сумма авторизации. Необходим для создания чека возврата на разницу суммы авторизации и клиринга
pg_salt Случайная строка
pg_sig Подпись