Интеграция альфа банк

Информация о сервисе

Моментальные платежи – это сервис для организации расчетов между юридическими лицами (ЮЛ) и индивидуальными предпринимателями (ИП), который позволяет формировать и отслеживать статус платежного документа в СберБизнес плательщика.

Ядро механизма сервиса составляют платежные поручения, которые используются в качестве платежных документов для расчетов между компаниями.

Платёжное поручениеПлатежное поручение – это документ, который используется для указания банку перевести определенную сумму денег с одного счета на другой. Обычно это делается, когда компания хочет произвести оплату за товары или услуги, перевести деньги индивидуальному предпринимателю или юридическому лицу.Платежные поручения используются широким кругом лиц, включая индивидуальных предпринимателей, малый и средний бизнес, крупные корпорации и даже государственные учреждения. Их используют, когда нужно сделать перевод, который требует предварительного уведомления или планирования (например, оплата аренды, коммунальных услуг или выплата заработной платы).

До начала разработки интеграции с сервисом потребуется:

Без сервиса СберБизнес ID настроить работу “Моментальные платежи” невозможно.

Схема работы сервиса

В рамках Платформы вы самостоятельно разрабатываете ролевую модель и настраиваете права доступа к функциональности.

Ниже, в качестве примера, приведена диаграмма вариантов использования:

Оплата на счет вашей компании в СбербанкеПолучить access_tokenСформировать черновик платежного порученияПодписать черновик платежного порученияПроверить статус оплатыПроверить корректность платежаКлиент – представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары вашей компании;Платформа – любой web-ресурс (интернет-магазин, мобильное приложение и т.д.), который вы используете в рамках клиентского пути Клиентов;Банк – в контексте данного usecase представляет из себя ресурсы и ресурсы Sber API, к которым обращается Платформа, и СберБизнес, на который переадресовывают Клиента для проведения оплаты.Клиент имеет пользовательский профиль в СберБизнес своей компании с правом подписи;Клиент находится на Платформе.Проведена оплата за товары/услуги на счет вашей компании.

Расчеты B2BПолучить access_tokenСформировать черновик платежного порученияПодписать черновик платежного порученияПроверить статус оплатыПроверить корректность платежаКлиент – представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары (вашей или другой) компании;Платформа – любой web-ресурс (интернет-магазин, мобильное приложение и т.д.), который вы используете в рамках клиентского пути Клиентов;Банк – в контексте данного usecase представляет из себя ресурсы и ресурсы Sber API, к которым обращается Платформа, и СберБизнес, на который переадресовывают Клиента для проведения оплаты.Клиент имеет пользовательский профиль в СберБизнес своей компании с правом подписи;Клиент находится на Платформе.Проведена оплата за товары/услуги на счет (вашей или другой) компании.

Платежи в бюджетПолучить реквизиты оплатыПолучить access_tokenСформировать черновик платежного порученияПодписать черновик платежного порученияПроверить статус оплатыПроверить корректность платежаКлиент – представитель ЮЛ/ИП, который от лица своей компании хочет сделать оплату в пользу бюджетной организации через Плафторму;Платформа – любой web-ресурс (интернет-магазин, мобильное приложение и т.д.), который вы используете в рамках клиентского пути Клиентов;Банк – в контексте данного usecase представляет из себя ресурсы и ресурсы Sber API, к которым обращается Платформа, и СберБизнес, на который переадресовывают Клиента для проведения оплаты.Клиент имеет пользовательский профиль в СберБизнес своей компании с правом подписи;Клиент находится на Платформе.Проведена оплата в пользу бюджетной компании.

Переадресация на платежное поручение

Чтобы Банк начал обработку платежного поручения, платежное поручение должно быть подписано. В клиентском пути сервиса платежное поручение формируется в клиентской части СберБизнес Клиента, поэтому и подписывать платежное поручение должен Клиент.

Для реализации бесшовного перехода в клиентскую часть СберБизнес необходима переадресация Клиента. Перейдя по ссылке в сервис оплаты, клиент пройдет аутентификацию, выберет счет списания и подпишет черновик платежного поручения для его исполнения Банком.

Ссылка переадресации выглядит следующим образом:

Создать черновик платежного поручения (отправка на свой счет в Сбербанке)

Ресурс позволяет вам создавать черновики платежных поручений с фиксированным сроком действия, в которых отсутствует возможность изменить сумму оплаты и реквизиты получателя. Получение денежных средств с помощью данного ресурса возможно только на расчетный счет в Сбербанке, который принадлежит вашей организации.

Для создания черновика платежного поручения необходимо отправить POST-запрос /v1/payments/from-invoice с токеном доступа (access_token) пользователя в параметре Authorization заголовка и реквизитами счета в теле запросе.

В параметре scope ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU_INVOICE для получения доступа к этому ресурсу.

Для обращения к ресурсу необходимо отправлять запрос на:

Создать черновик платежного поручения (отправка в любой банк)

Ресурс позволяет вам создавать черновики платежных поручений по свободным реквизитам. Получение денежных средств возможно на счета сторонних банков. В качестве получателя денежных средств может выступать любая организация.

Для создания черновика платежного поручения необходимо отправить POST-запрос /v1/payments/from-invoice-any с токеном доступа (access_token) пользователя в параметре Authorization заголовка и реквизитами счета в теле запросе.

В параметре scope ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU_INVOICE_ANY для получения доступа к этому ресурсу.

Создать черновик платежного поручения (отправка в бюджет)

Ресурс позволяет вам создавать черновики платежных поручений в адрес бюджетных организаций со счетом в любом банке для оплаты налоговых, таможенных и других бюджетных платежей.

Для создания черновика платежного поручения необходимо отправить POST-запрос /v1/payments/from-invoice-budget с токеном доступа (access_token) пользователя в параметре Authorization заголовка и реквизитами счета в теле запросе.

В параметре scope ссылки авторизации пользователя должен быть указан сервис PAY_DOC_RU_INVOICE_BUDGET для получения доступа к этому ресурсу.

Получить статус платежного поручения

Ресурс позволяет вам получить статус ранее сформированного черновика платежного поручения. В случае, если у Клиента отключена/истек срок соглашения услуги на формирование платежных поручений, вы все равно сможете получить статус готовых документов.

В параметре scope ссылки авторизации пользователя для получения доступа к этому ресурсу должен быть указан один из сервисов:

Статусы платежных поручений

bankStatus (string)Код состояние документаНаименование статусаНазначение кода состоянияПромежуточный/Продолжать опрашиватьACCEPTEDПринятЭлектронный документ принят на стороне БанкаACCEPTED_BY_ABSПринят АБС илиПринятЭлектронный документ был принят к обработке в АБС БанкаCARD2Картотека 2 илиОжидает оплатыАБС обнаружено, что на счете плательщика недостаточно средств для иcполнения документаCREATEDСозданДокумент записан в БД, проверки не выполнялисьCHECKERRORОшибка контроляЭД сформирован, но при сохранении не прошел проверку корректности заполнения полей и сохранен с имеющимися в нем ошибкамиDELAYEDПриостановленОбработка электронного документа была приостановленаDELIVEREDДоставленЗапрос доставлен в ДБО и взят в обработкуDELIVERED_RZKДоставлен в СБКЭлектронный документ отправлен в СБК и получен квиток о доставкеFRAUDALLOWОдобрен ФРОДПроверка во ФРОДЕ прошла успешно, переход на «Принят»FRAUDDENYОтвергнут ФРОДДокумент отказан на основе проверки в АС Fraud-мониторинг, переходим в «Отвергнут банком»FRAUDREVIEWНа проверке у специалиста БанкаСо стороны ФРОД-анализа получен статус документа «На проверке у специалиста Банка»FRAUDSENTОтправлен во ФРОДДокумент отправлен на проверку в АС Fraud-мониторингFRAUDSMSТребуется подтверждение sms-паролемСо стороны ФРОД-анализа получен статус документа «Требуется подтверждение sms-паролем»NOT_ACCEPTED_RZKНе принят СБКЭлектронный документ не прошел логические контроли СБКPARTSIGNEDЧастично подписанЭД подписан частью подписей, входящих в предусмотренный для данного документа комплект подписейPROCESSING_RZKОбрабатывается СБКЭД успешно прошел проверки ЭП и логические проверки СБКREQUESTED_RECALLЗапрошен отзывДокумент отозванRZK_SIGN_ERRORОшибка ЭП СБКПроверка подписи под ЭД на стороне СБК дала отрицательный результатSENDING_TO_RZKОтправляется в СБКЭлектронный документ отправлен в СБК, но не получен квиток о доставкеSIGNEDПодписанЭД подписан предусмотренным для него комплектом подписей.TO_PROCESSING_RZKК отправке в СБКЭД подписан предусмотренным для него комплектом о доставкеОкончательный (Не успешный)/Прекратить опросDELETEDУдаленЭлектронный документа удален из числа действующих документовINVALIDEDSЭП/АСП не вернаПодпись невернаПроверка ЭП под ЭД на стороне Банка дала отрицательный результатRECALLОтозванЭлектронный документ был отозван Клиентом по запросуREFUSEDBYBANKОтвергнут банком илиОтклонен банкомЭлектронный документ отвергнут банкомREFUSEDBYABSОтказан АБСЭлектронный документ не прошел проверки в АБСREQUISITEERRORОшибка реквизитовВ ЭД указаны ошибочные реквизитыREFUSED_BY_RZKОтказан контролирующей организациейЭлектронный документ не прошел проверки контролирующей организациейОкончательный (Успешный)/Прекратить опросIMPLEMENTEDИсполненЭлектронный документ исполнен Банком