Перейти к основному содержимому

Платёжные поручения (исходящие платежи)

Для работы с исходящими платежами должны быть выданы разрешения CreatePaymentForSign и CreatePaymentOrder.

Платёжное поручение, платёжка — это распоряжение банку перевести деньги по реквизитам. Через API платёжки нужны для исходящих платежей: рассчитаться с контрагентом, заплатить налог, перечислить зарплату или отправить деньги физлицу — всё из вашего сервиса, без захода в интернет-банк.

Как устроена отправка платежа​

Ключевой принцип: API сам деньги не отправляет. Он только готовит платёжку, а финальное подтверждение даёт живой сотрудник. Так исключаются случайные и несанкционированные списания — код физически не может отправить деньги без подписи человека.

  1. Создайте платёжку методом Create Payment For Sign. Она появится в интернет-банке в разделе «На подпись».
  2. Подпишите её. Сотрудник, которому в интернет-банке выдан тип доступа «С правом подписи», вводит смс-код — и деньги уходят получателю.
Совет

В ответе на создание платёжки приходит ссылка в поле Data.redirectURL — она ведёт сразу на страницу подписания. Перенаправьте по ней сотрудника, чтобы он не искал платёж в интернет-банке вручную.

Что подготовить для платёжки​

Полный список полей — на странице метода Create Payment For Sign. По сути нужно собрать:

  • счёт списания — с какого вашего счёта уходят деньги.
  • реквизиты получателя — счёт, БИК банка, ИНН, наименование.
  • сумму платежа
  • назначение платежа — за что переводите. От текста назначения зависит, как платёж обработает банк-получатель.
  • очерёдность (paymentPriority) — в какую очередь спишется платёж.

Для налоговых и других бюджетных платежей дополнительно заполняются поля 101 и 104–110, то есть КБК, ОКТМО, основание, налоговый период и другие. Для платежей физлицам на некоторые типы счетов нужен код вида дохода - codePurpose.

Очерёдность платежа​

Очерёдность (paymentPriority) — это порядок, в котором банк спишет платёж, если денег на счёте не хватает на всё сразу. Определяется статьёй 855 Гражданского кодекса.

По умолчанию — 5: обычные платежи контрагентам. Значения 1–4 зарезервированы для приоритетных списаний - возмещение вреда жизни и здоровью, алименты, зарплата, налоги по требованию. Если не уверены — оставляйте 5.

Путь платежа​

Отследить, на каком этапе платёж, можно методом Get Payment Status.

СтатусЧто означает
WaitingForCreateПлатёж создан, ждёт подписания в интернет-банке
CreatedПлатёж подписан и передан в обработку
PaidПлатёж оплачен, деньги ушли получателю
CanceledПлатёж отменён
RejectedПлатёж отклонён банком
Совет

Чтобы сразу узнавать об исходящих платежах, а не опрашивать статус вручную, настройте вебхук с событием outgoingPayment.

Методы​

  • Create Payment For Sign — создать платёжку и отправить её на подпись. В ответе приходит Data.redirectURL — ссылка на страницу подписания.

  • Get Payment For Sign List — получить все платежи из раздела «На подпись».

  • Get Payment Status — проверить статус платежа, созданного методом Create Payment For Sign.

Что важно знать​

  • В ответе Get Payment For Sign List приходят платежи, созданные и через API, и вручную в интернет-банке. Данные актуальны на момент вызова метода.
  • Если платёж создан по API, а затем отредактирован в интернет-банке, Get Payment Status перестанет показывать его актуальный статус — он всегда будет Created.
  • Платёж со статусом Rejected банк не пропустил. Частые причины: на счёте недостаточно денег, неверные реквизиты получателя, ошибка в реквизитах бюджетного платежа.
  • Деньги по подписанному платежу уходят в операционное время банка. Платёж, подписанный в выходной или вне операционного дня, отправится в ближайший рабочий день.