ДеньгиOnline

2017-01-16 19:48:08

Платежи с протекцией

Для снижения рисков при осуществлении выплат могут использоваться выплаты с протекцией. При выплате с протекцией платеж находится в стадии processing, пока:

  • получатель не введет код протекции или
  • не закончится заданный отправителем срок протекции.

Сейчас протекция платежей поддерживается для следующих услуг:

Параметры запроса

Для использования протекции необходимо, помимо общих параметров для действия Pay, передать дополнительные:

Параметр Описание Тип данных Обязательность
protection_period Срок протекции платежа (дни) integer Да

Получив параметр, Система генерирует десятизначный protection_code и отправляет его концентратору с заданным в protection_period сроком.

Параметры ответа

Ответ Системы в формате xml, помимо общих параметров для действия Pay, содержит следующие теги в ноде <extra>:

Параметр Описание Тип данных
protection_code Код протекции платежа string(10)
Передача protection_code получателю осуществляется отправителем самостоятельно.

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

<request>
    <project>1290</project>
    <timestamp>1360928333</timestamp>
    <action>pay</action>
    <params>
        <paysystem>1000</paysystem>
        <account>R123123123123</account>
        <amount>10.00</amount>
        <protection_period>3</protection_period>
    </params>
</request>

Пример ответа

<?xml version="1.0" encoding="UTF-8"?>
<response>
	<status>1</status>
	<reference>501583</reference>
	<timestamp>1360928334</timestamp>
	<invoice>30876</invoice>
	<income>12.34</income>
	<rate>1</rate>
	<amount>12.34</amount>
	<outcome>12.34</outcome>
	<fee>-0.617</fee>
	<extra>
		<protection_code>12345abcde</protection_code>
	</extra>
</response>