Список и информация
Методы этого раздела помогают найти сделки по фильтрам и получить подробности по конкретной сделке.
Список сделок
Метод list_deals возвращает сделки по фильтрам — по статусу, датам создания и обновления, внешнему ключу. В параметре field_names вы перечисляете, какие поля вернуть по каждой сделке: сумму, статус, даты, внешний ключ. Поля метода — в автогенерируемом описании Получить список сделок.
Метод можно вызывать не чаще одного раза в 5 минут с одинаковыми параметрами.
Раньше для списка сделок использовался метод list_deal — он устарел. Он ещё работает для совместимости, но в нём нет фильтров по дате обновления и части статусов. Для новых интеграций используйте list_deals.
Возможные ошибки
Метод возвращает список по фильтрам и специфичных ошибок не имеет. Общий формат ошибок описан в разделе Формат логических ошибок.
Информация по сделке
Метод get_deal возвращает всё по одной сделке: сумму, статус, плательщиков с их документами, получателей со статусом каждой выплаты и связанным платежом. Поля метода — в автогенерируемом описании Получить данные сделки.
По каждому получателю приходит статус исполнения выплаты: new — ещё не запущена, in_process — в процессе оплаты, reject — при оплате получен отказ, success — успешная оплата. Если выплата шла на карту, в блоке платежа приходит дополнительная информация: rrn для успешного платежа и код с описанием ошибки для отменённого. Метод можно вызывать не чаще одного раза в 5 минут по одной сделке.
Возможные ошибки
| Код | Текст |
|---|---|
4417 | Not found deal |