ДеньгиOnline

2017-01-16 19:48:08

Действие pay_status

Получение статуса транзакции по ее идентификатору

Действие pay_status предназначено для выяснения текущего статуса транзакции. Запрос проводится после успешного запроса на произведение выплаты (Действие pay).

Внимание!

В оперативном доступе хранятся данных о платежах за 2 месяца. Более старые транзакции перемещаются в архив, и получение информации о них через API становится невозможным. 

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

Запрос, помимо обязательных общих параметров, содержит в теге params следующие параметры:

Параметр Описание Тип данных Обязательность
invoice ID транзакции, полученный в действии check integer Нет
txn_id ID транзакции во внешней системе (системе проекта) string (255) Да

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

Ответ Системы в формате xml содержит, помимо общих, следующие теги:

Параметр Описание Формат параметра
pay_status

Статус транзакции:

  • new – новая, не проведена;
  • processing – обрабатывается сейчас;
  • pending – в очереди, ожидает обработки;
  • paid – выплата проведена;
  • error – ошибка выплаты;
  • canceled– выплата отменена, средства возвращены на баланс проекта,
  • expired– превышен интервал ожидания для проведения транзакции

Статус платежа определяется только по полю pay_status!

string (255)
income Сумма входящего платежа в его валюте decimal(11.4)  разделитель – точка
rate Использованный курс конвертации decimal(11.4)  разделитель – точка
amount Сумма входящего платежа в валюте основного баланса decimal(11.4)  разделитель – точка
outcome Сумма выплаты в систему-получатель decimal(11.4)  разделитель – точка
fee % комиссии по данному провайдеру decimal(11.4)  разделитель – точка
ts_create Дата создания инвойса Дата в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС
ts_close

Дата произведения выплаты

Дата в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС

Повторите запрос PAY_STATUS, если отсутствует тело ответа или ответ не соответствует XML-формату или указанному набору параметров.

При внутренней ошибке в системе (1000 - INTERNAL_ERROR) возможно отсутствие нод reference и timestamp в ответе.

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

<?xml version="1.0" encoding="UTF-8"?>
<request>
    <action>pay_status</action>
    <project>1234</project>
    <timestamp>1358268163</timestamp>
    <params>
        <invoice>30080</invoice>
    </params>
<sign>2c4a5a47b6ff89320a61330eac853f81</sign>
</request>

Пример ответа (успех)

 <?xml version="1.0" encoding="UTF-8"?>
<response>
    <status>1</status>
    <reference>25107</reference>
    <timestamp>1358268162</timestamp>
    <pay_status>paid</pay_status>
    <income>10.0000</income>
    <amount>10.00</amount>
    <outcome>10.00</outcome>
    <fee>0.0000</fee>
    <rate>1.0000</rate>
    <ts_create>2013-01-15 20:41:48</ts_create>
    <ts_close>2013-01-15 20:42:06</ts_close>
</response>

Пример ответа (ошибка)

 <?xml version="1.0" encoding="UTF-8"?>
<response>
    <status>22</status>
    <reference>25108</reference>
    <timestamp>1358268196</timestamp>
</response>