ДеньгиOnline

2019-03-22 17:33:12

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

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

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

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

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

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

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

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

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

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

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

Пример запроса (XML)

<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>

Пример запроса (JSON)

{
  "request": {
    "project": "1290",
    "timestamp": "1360928333",
    "action": "pay",
    "params": {
      "paysystem": "1000",
      "account": "R123123123123",
      "amount": "10.00",
      "protection_period": "3"
    }
  }
}

Пример ответа (XML)

<?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>

Пример ответа (JSON)

 {
  "response": {
    "status": "1",
    "reference": "501583",
    "timestamp": "1360928334",
    "invoice": "30876",
    "income": "12.34",
    "rate": "1",
    "amount": "12.34",
    "outcome": "12.34",
    "fee": "-0.617",
    "extra": { 
      "protection_code": "12345abcde" 
   }
  }
}