Как выглядит платежное поручение сбербанка
РАБОТА С БАНКОМ
6 МИН
Дата публикации: 5 июня 2023
Что такое платёжное поручение и для чего оно нужно
Какие данные указывать в платёжном поручении, как быстро банк его исполнит и что будет, если допустить ошибку в реквизитах — разбираемся вместе с основателем аутсорсинговой компании «Бизнес Финанс Груп» Евгенией Зубовой.
Что такое платёжное поручение и для чего оно нужно
Платёжное поручение, или платёжка — это документ, с помощью которого вы даёте банку задание перевести деньги с вашего счёта на счёт физического лица, компании или в бюджет.
В платёжном поручении указывают:
- номер платёжки и дату;
- ФИО физического лица, ИП или наименование организации — плательщика и получателя;
- ИНН и КПП плательщика и получателя;
- сумму платежа цифрами и прописью;
- номер корреспондентского счёта, БИК и наименование банка плательщика и получателя;
- номер счёта получателя;
- вид операции;
- назначение платежа (о том, как указывать его корректно, — в нашей статье);
- ОКТМО — код муниципального образования.
Другие поля заполняют по желанию или в зависимости от вида платежа.
Скачать стандартную форму платёжного поручения можно здесь. Для уплаты налогов можно заполнить платёжку с помощью онлайн-сервиса ФНС.
Как провести платёж в офисе банка
Вы можете заранее заполнить бланк платёжного поручения и принести его в отделение банка в распечатанном виде. Если нет времени заполнять бланк или боитесь допустить ошибку — оформить документ за вас может сотрудник банка. Однако в последнее время «бумажные» платёжки встречаются всё реже.
Как провести платёж в интернет-банке
Заполнить платёжное поручение в интернет-банке проще, чем самостоятельно на бумаге. Некоторые поля уже будут предзаполнены, останется только ввести недостающие данные, пользуясь подсказками, и платёжка сформируется автоматически. При отправке через интернет-банк платёжное поручение подписывается электронной подписью собственника бизнеса или сотрудника, на которого оформлена доверенность. О том, какие бывают доверенности и как их оформлять, мы написали в отдельной статье.
Примерно таким же образом платёжное поручение заполняется и в бухгалтерских программах.
Если бухгалтерская программа, предположим «1С», синхронизирована с интернет-банком, то остаётся только нажать в ней кнопку «Отправить», и платёжка сразу отображается в интернет-банке.
Евгения Зубова,
основатель аутсорсинговой компании «Бизнес Финанс Груп»
При открытии счёта и выборе тарифа обращайте внимание на стоимость исполнения платёжных поручений.
В каждый пакет услуг СберБизнеса входят платежи без комиссии. Например, ПУ «Только для ИП» включает в себя 10 переводов юридическим лицам, а также переводы физическим лицам до 500 000 рублей в месяц. Предпринимателям, которые делают много переводов юрлицам, подойдёт ПУ «Полным ходом»: в него включено 75 платежей в месяц, или «Двойной Полным ходом» — в нём 150 платежей без комиссии. За исполнение платёжных поручений сверх этих лимитов банк берёт плату — по 100 рублей за платёжку. Подобрать подходящий пакет услуг и открыть счёт можно онлайн.
Как исполняются платёжные поручения и что бывает, если ошибиться в реквизитах
По закону банк исполняет платёжки в срок до двух банковских (операционных) дней, если деньги переводятся в пределах одного субъекта РФ, и до 5 дней, если плательщик и получатель находятся в разных регионах. Это максимальный срок — на деле всё обычно происходит быстрее. Конечно, если все обязательные поля платёжки заполнены, а на счёте отправителя хватает средств. Если на счёте недостаточно денег для совершения операции, банк всё равно принимает платёжки — они образуют очередь и исполняются по мере пополнения баланса.
Если в платёжном поручении ошибка — например, неправильно указан номер корреспондентского счёта или БИК банка — платёж не будет исполнен, деньги автоматически вернутся на счёт отправителя в срок до 5 дней (чаще всего быстрее).
В последние годы всё реже возникает необходимость писать заявление на расследование и поиск платежа, хотя раньше платежи часто терялись и на поиск денег уходило до 1 месяца.
Если допущена ошибка в наименовании организации — например, неправильно указана одна буква — платёж, вероятнее всего, пройдёт, так как основной индикатор для банка — это ИНН.
Евгения Зубова,
основатель аутсорсинговой компании «Бизнес Финанс Груп»
Если из-за ошибки в платёжном поручении деньги отправились не тому адресату, то отозвать платёж, скорее всего, не получится: из-за высокого уровня автоматизации документы уходят в работу практически мгновенно. В данном случае единственный способ всё исправить — связаться с получателем и попросить его вернуть деньги. В случае отказа можно попробовать восстановить справедливость через суд.
Платёжное поручение и платёжное требование: в чём отличие
Кроме платёжного поручения, существуют и другие документы, на основании которых банк может перевести деньги с вашего счёта на счёт того или иного адресата. Например, платёжное требование: с его помощью другая организация может запросить у вас плату за товар или услугу. Платёжное требование бывает с акцептом плательщика (деньги списываются после вашего подтверждения) или без него (оплата происходит автоматически).
Чаще всего платёжные требования рассылают ресурсоснабжающие компании — для списания платы за электричество или газ. Для расчётов между контрагентами — поставщиками и покупателями — в малом бизнесе такой вид документа используется редко.
Есть и другие виды платёжных документов. Для безакцептного списания денег в пользу судебных приставов используется инкассовое поручение, а для расчётов между банком и клиентом — например, списания платежа по кредиту или начисления процентов на остаток по счёту — банковский ордер.
И всё же обычное платёжное поручение остаётся самым востребованным типом документа для перевода денег с одного счёта на другой.
Платежное поручение
Для обращения к ресурсу необходимо отправлять запрос на:
- Текущий тестовый контур https://edupirfintech.sberbank.ru:9443
- Новый тестовый контур https://iftfintech.testsbi.sberbank.ru:9443
- Промышленный контур https://fintech.sberbank.ru:9443
Создание платежных поручений
Ресурс /v1/payments позволяет Партнеру создавать дебетовые платежные поручения по собственным счетам.
Шаги
1. Получить AccessToken.
2. Сформировать ЭП.
3. Отправить запрос.
4. Получить статус.
5. Получить документ.
Для создания рублевого платежного поручения необходимо отправить POST-запрос (/v1/payments), в котором передать авторизационный токен к данным собственной организации (Access Token) и реквизиты одного платежного поручения. Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU .
Модель запроса и ответа
| Наименование | Описание |
|---|---|
| Параметры заголовка | |
| Authorization (String) | Access token собственной организации, полученный через SSO Пример: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1 |
| Параметры тела запроса | |
| Payment | |
| amount (number) | Сумма платежа, |
| bankComment (string, optional, read only) | Банковский комментарий к статусу документа, |
| bankStatus (string, optional, read only) | Статус документа, |
| crucialFieldsHash (string, optional, read only) | Hash от ключевых полей документа, |
| date (string) | Дата составления документа, |
| deliveryKind (string, optional) | Вид платежа: электронно, срочно Если не заполнено или 0, то будет присвоено значение «электронно», |
| departmentalInfo (DepartmentalInfo, optional) | Реквизиты налогового, таможенного или иного бюджетного платежа, |
| digestSignatures (Array [Signature] , optional) | Электронные подписи по дайджесту документа, |
| externalId (string) | Идентификатор документа, присвоенный партнером (UUID), |
| incomeTypeCode (string, optional) | Код вида дохода получателей выплаты по 229-ФЗ. Коды: 1 — При переводе денежных средств, являющихся заработной платой и (или) иными доходами, в отношении которых статьей 99 Федерального закона N 229-ФЗ установлены ограничения, 2 — При переводе денежных средств, являющихся доходами, на которые в соответствии со статьей 101 Федерального закона N 229-ФЗ не может быть обращено взыскание, за исключением доходов, указанных в пунктах 1 и 4 части 1 статьи 101 Федерального закона N 229-ФЗ), 3 — При переводе денежных средств, являющихся видами доходов, на которые в соответствии с пунктами 1 и 4 части 1 статьи 101 Федерального закона N 229- ФЗ не может быть обращено взыскание, |
| number (string, optional) | Номер документа Обратите внимание: номер документа должен быть не более 6 цифр, |
| operationCode (string) | Код операции:1 |
| payeeAccount (string, optional) | Счет получателя платежа, |
| payeeBankBic (string) | БИК получателя платежа, |
| payeeBankCorrAccount (string, optional) | Корсчет банка получателя платежа, |
| payeeInn (string, optional) | ИНН получателя платежа, |
| payeeKpp (string, optional) | КПП получателя платежа, |
| payeeName (string) | Полное наименование получателя платежа, |
| payerAccount (string) | Счет плательщика, |
| payerBankBic (string) | БИК банка плательщика, |
| payerBankCorrAccount (string) | Корсчет банка плательщика, |
| payerInn (string) | ИНН плательщика, |
| payerKpp (string, optional) | КПП плательщика, |
| payerName (string) | Полное наименование плательщика, |
| priority (string) | Очередность платежа: 1, 2, 3, 4, 5, |
| purpose (string) | Назначение платежа Размерность: [1 .. 210] , |
| urgencyCode (string, optional) | Код срочности = [‘INTERNAL’ — срочный, ‘INTERNAL_NOTIF’ — срочный платеж с уведомлением, ‘OFFHOURS’ — неотложный, ‘BESP’ — банковские электронные срочные платежи, ‘NORMAL’ — срочность не указана] stringEnum: 0, 1, 2, 3, 4, |
| vat (Vat, optional) | Данные НДС, |
| voCode (string, optional) | Код вида валютной операции |
| >DepartmentalInfo | |
| uip (string, optional) | Уникальный идентификатор платежа, |
| drawerStatus101 (string, optional) | Показатель статуса налогоплательщика (реквизит — 101), |
| kbk (string, optional) | Код бюджетной классификации (реквизит — 104), |
| oktmo (string, optional) | Код OKTMO (реквизит — 105), |
| reasonCode106 (string, optional) | Показатель основания платежа (реквизит — 106), |
| taxPeriod107 (string, optional) | Налоговый период / код таможенного органа (реквизит — 107), |
| docNumber108 (string, optional) | Номер налогового документа (реквизит — 108) Должно быть проставлено значение: 0 или пустое или цифровое, |
| docDate109 (string, optional) | Дата налогового документа в формате YYYY-MM-DD (реквизит — 109), |
| paymentKind110 (string, optional) | Тип налогового платежа (реквизит — 110) |
| >Signature | |
| base64Encoded (string) | Значение электронной подписи, закодированное в Base64, |
| certificateUuid (string) | Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID) |
| >Vat | |
| amount (number, optional) | Сумма НДС, |
| rate (string, optional) | Ставка НДС: 0,10,20, |
| type (string) | Способ расчета НДС = [‘INCLUDED’ — НДС включен в сумму платежа, ‘NO_VAT’ — не облагается НДС, ‘MANUAL’ — ручной ввод НДС] stringEnum: «0», «2», «3» |
| > |
Пример запроса
"amount":1.01, "bankComment":"string", "bankStatus":"string", "date":"2018-12-31", "deliveryKind":"электронно", "departmentalInfo": "uip":"0", "drawerStatus101":"01", "kbk":"18210102010011000110", "oktmo":"01701000", "reasonCode106":"ТП", "taxPeriod107":"ГД.00.2018", "docNumber108":"123", "docDate109":"2017.01.01", "paymentKind110":"1" >, "digestSignatures":[ "base64Encoded":"HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w==", "certificateUuid":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6" > ], "externalId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6", "incomeTypeCode":"2", "number":"1", "operationCode":"01", "payeeAccount":"40802810600000200000", "payeeBankBic":"044525225", "payeeBankCorrAccount":"30101810400000000225", "payeeInn":"7707083893", "payeeKpp":"222201001", "payeeName":"Общество с ограниченной ответственностью \"Клиент\"", "payerAccount":"40802810600000200000", "payerBankBic":"044525225", "payerBankCorrAccount":"30101810400000000225", "payerInn":"7707083893", "payerKpp":"222201001", "payerName":"Общество с ограниченной ответственностью \"Клиент\"", "priority":"5", "purpose":"Оплата заказа №123. НДС нет.", "urgencyCode":"INTERNAL", "vat": "amount":0.00, "rate":"0", "type":"NO_VAT" >, "voCode":"61150" > Если требуется проверить неизменность реквизитов получателя платежа до получения выписки с информацией о проведенном документе, необходимо сравнить хэш реквизитов получателя (crucialFieldsHash), полученный при создании черновика документа, с crucialFieldsHash полученным при запросе статуса документа. Для вычисления значения хэша ключевых полей формируется строка из реквизитов, соединенных между собой: БИК банка получателя, счет получателя платежа, сумма платежа, (разделитель-точка).
Документы, поступающие в банк по каналу Fintech, проходят проверку на уникальность поля «externalId». Если в банке уже есть документ с указанным в запросе «externalId», то запрос будет отклонен системой.
В АС Банка также присутствует проверка на дублирование документов по полям: — номер документа; — дата документа; — сумма документа.
Если поля совпадают с уже существующим в банке документом, то такой документ получает статус «bankStatus»: «CHECKERROR», а комментарий «bankComment»: «Документ с такими реквизитами уже существует.»
Поле «number» не является обязательным, однако, если оно не заполнено, то номер присваивается автоматически.
Передача электронной подписи вместе с документом
Требования к ЭЦП:
- Подпись CMS;
- Подпись открепленная — detatched;
- Формат подписи — PEM;
- Алгоритм цифровой подписи ГОСТ Р 34.10-2012 для ключей длины 256 бит;
- Блок с сертификатами (Certificates) обязателен — включает сертификат подписанта;
- Данные подписанта (Signer Info) — содержит информацию только по одному подписанту;
- Передается в API значение подписи, закодированное в Base64.
В API передается значение подписи, закодированное в Base64. Base64 строка не должна содержать спец. символов (\r, \n, \t и т.п.). Рекомендация: Проверить сформированную подписи можно на странице https://www.sberbank.ru/ru/s_m_business/id-center Выбрать раздел «Проверка электронной подписи» Выбрать тип электронной подписи — Отсоединенная (электронная подпись содержится в отдельном файле)
Для передачи ЭП под документом используется массив digestSignatures, в котором передаются элементы типа Signature:
| Наименования поля | Описания поля | Пример |
|---|---|---|
| Обязательные поля | ||
| base64Encoded (string) | Значение ЭП документа | HlaeIHXXEcGT1bFxo1NlpAzpr+kJ2IQrcxVdvDTep6xjsmD1FDb+6NIyLT+/T24S0mPfVCU75sieOMt71TBS7w== |
| certificateUuid (string) | Идентификатор сертификата, использованного при создании ЭП ( можно узнать, обратившись к ресурсу /v1/crypto) | 22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6 |
Для платежных поручений, создаваемым по собственным счетам можно передать одну или две электронных подписей (или не передавать при отсутствии ЭП) вместе с реквизитами создаваемого документа . Если ЭП передана/ы в API, то они сохраняются вместе с документом, а сам документ продвигается дальше по своему жизненному циклу. Если ЭП не была/и передана/ы, то документ сохраняется в своем начальном статусе и ожидает дальнейшего подписания в интерфейсе СББОЛ.
Документ может быть подписан следующими наборами подписей:
- одна (единственная) подпись;
- первая и вторая подписи.
При этом подписант, обладающий полномочием единственной подписи, не может «сочетаться» с подписантом, владеющим первой или второй подписью.
Очередность наложения ЭП при наложении первой и второй подписей не имеет значения, состав полей дайджеста не изменяется. Тип подписи указывается в настройках криптопрофиля, когда пользователь Партнера создается в Банке.
Формат дайджеста РПП
| Наименование поля | Описание поля | Пример |
|---|---|---|
| amount | Сумма платежа | 100.00 |
| date | Дата составления документа | 2018-05-31 |
| departmentalInfo.docNumber108 | Номер налогового документа(реквизит-108) | 123 |
| departmentalInfo.drawerStatus101 | Показатель статуса налогоплательщика(реквизит-101) | 01 |
| departmentalInfo.kbk | Код бюджетной классификации(реквизит-104) | 18210102010011000110 |
| departmentalInfo.oktmo | Код ОКТМО(реквизит-105) | 1701000 |
| departmentalInfo.paymentKind110 | Тип налогового платежа(реквизит-110) | НС |
| departmentalInfo.reasonCode106 | Показатель основания платежа(реквизит-106) | ТП |
| departmentalInfo.uip | Уникальный идентификатор платежа | 0 |
| externalId | Идентификатор документа, присвоенный сервисом | a0000000-0000-0000-0000-000000000001 |
| incomeTypeCode | Код вида дохода получателей выплаты по 229-ФЗ | 2 |
| operationCode | Код операции | 01 |
| payeeAccount | Номер счета получателя | 40702810600100001212 |
| payeeBankBic | БИК получателя | 044525225 |
| payeeBankCorrAccount | Корсчет банка получателя | 30101810400000000225 |
| payeeInn | Инн получателя | 222201236445 |
| payeeKpp | Кпп получателя | 222201001 |
| payeeName | Полное наименование получателя платежа | Общество с ограниченной ответственностью «Получатель» |
| payerAccount | Счет плательщика | 40702810500006103990 |
| payerBankBic | БИК плательщика | 044525225 |
| payerBankCorrAccount | Корсчет банка плательщика | 30101810400000000225 |
| payerInn | ИНН плательщика | 222201236445 |
| payerKpp | КПП плательщика | 222201001 |
| payerName | Полное наименование плательщика | Общество с ограниченной ответственностью «Клиент» |
| priority | Очередность платежа | 5 |
| purpose | Назначение платежа | Оплата интернет заказа №123. НДС нет. |
| voCode | Код вида валютной операции | 61150 |
Пример дайджеста
amount=100.00 date=2018-05-31 departmentalInfo.docNumber108=123 departmentalInfo.drawerStatus101=01 departmentalInfo.kbk=18210102010011000110 departmentalInfo.oktmo=01701000 departmentalInfo.paymentKind110=НС departmentalInfo.reasonCode106=ТП departmentalInfo.uip=0 externalId=a0000000-0000-0000-0000-000000000001 incomeTypeCode=2 operationCode=01 payeeAccount=40702810600100001212 payeeBankBic=044525225 payeeBankCorrAccount=30101810400000000225 payeeInn=222201236445 payeeKpp=222201001 payeeName=Общество с ограниченной ответственностью "Получатель" payerAccount=40702810500006103990 payerBankBic=044525225 payerBankCorrAccount=30101810400000000225 payerInn=222201236445 payerKpp=222201001 payerName=Общество с ограниченной ответственностью "Клиент" priority=5 purpose=Оплата интернет заказа №123. НДС нет. voCode=61150 Получение статуса поручения
Ресурс /v1/payments//state позволяет получить статус платежного поручение.
Шаги
1. Получить AccessToken.
2. Отправить запрос.
Для получения статуса необходимо отправить GET-запрос (/v1/payments//state), в котором передать авторизационный токен к данным собственной организации (Access Token) и идентификатор документа (externalId). Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU .
Модель запроса
| Наименование | Описание |
|---|---|
| Параметры заголовка | |
| Authorization (String) | Access token полученный через SSO Пример: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1 |
| Параметры запроса | |
| externalId (String) | Идентификатор документа, присвоенный клиентом |
Пример запроса
curl -X GET --header 'Accept: /' --header 'Authorization: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1' 'https://edupirfintech.sberbank.ru:9443/fintech/api/v1/payments/ffffffff-fffa-458e-ad92-fff9497303ba/state' Модель ответа
| Наименование | Описание |
|---|---|
| PaymentDocState | |
| bankComment (string, optional, read only) | Банковский комментарий к статусу документа, |
| bankStatus (string, optional) | Статус документа, |
| channelInfo (string, optional, read only) | Комментарий, специфичный для документа, полученного по данному каналу, |
| crucialFieldsHash (string, optional) | Hash от ключевых полей документа |
| > |
Пример ответа
"bankStatus": "CREATED", "bankComment": null, "channelInfo": null, "crucialFieldsHash": "4888bdfe92812ebf1f70aa9be4b8a733" > Статусы обработки платежных документов
| Код состояние документа | Наименование статуса | Назначение кода состояния |
|---|---|---|
| Промежуточный/Продолжать опрашивать | ||
| 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 | Исполнен | Электронный документ исполнен Банком |
Получение атрибутов поручения
Ресурс /v1/payments/ позволяет получить атрибуты ранее отправленного рублевого платежного поручения.
Шаги
1. Получить AccessToken.
2. Отправить запрос.
Для получения платежного документа необходимо отправить GET-запрос (/v1/payments/ ), в котором необходимо передать авторизационный токен к данным собственной организации (Access Token) и внешний идентификатор платежного поручения. Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU .
Модель запроса
| Наименование | Описание |
|---|---|
| Параметры заголовка | |
| Authorization (String) | Access token полученный через SSO Пример: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1 |
| Параметры запроса | |
| externalId (String) | Идентификатор документа, присвоенный партнером |
Пример запроса
curl -X GET --header 'Accept: /' --header 'Authorization: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1' 'https://edupirfintech.sberbank.ru:9443/fintech/api/v1/payments/ffffffff-fffa-458e-ad92-fff9497303ba/state' Модель ответа
Соответствует модели запроса и ответа POST /v1/payments.
Дополнительная информация
Параметры НДС
Для корректной работы необходимо передавать параметры в следующем сочетании :
- Если блок vat не указан, то по умолчанию будут присвоены и придут в ответе на запрос следующие значения :
"vat": "type": "NO_VAT", "rate": "0", "amount": "0.00" > В поле «Назначение платежа» необходимо обязательно отправлять «НДС не облагается».
- При выбранном «type»:»INCLUDED» (НДС включен в сумму платежа) в атрибуте «amount» необходимо указать сумму НДС. Атрибут «rate» должен принимать только значения 10, 20. В поле «Назначение платежа» необходимо обязательно указать посчитанное значение НДС. Пример ПРАВИЛЬНОГО заполнения: НДС_10_%_-_100.63 рублей (нижнее подчеркивание является признаком пробела, символ проставлять не нужно). Если процентное значение не указано, то дефис перед суммой указывать не нужно: НДС_100.63 рублей .
- При выбранном «type»:»MANUAL» (Ручной ввод НДС) атрибут «amount» указывать не обязательно, но в этом случае по умолчанию сумма НДС примет значение 0 рублей. Если же атрибут «amount» указывается в запросе, то в нем нужно указать желаемое значение НДС, соответствующее формату. Если процентное значение не указано, то дефис перед суммой указывать не нужно: НДС_100.63 рублей .
Подписание запроса транспортной подписью
Content-Type может содержать одно из двух значений:
- application/json – запрос без подписи
- application/jose – запрос, подписанный транспортной подписью
Если Content-Type имеет значение application/jose, то запрос должен содержать данные (реквизитный состав платежного документа) в виде компактной сериализации RFC 7515: JSON Web Signature (JWS).
JWS состоит из:
1. Заголовка (Header) 2. JSON-документа с реквизитным составом платежного поручения (Payload) 3. Подписи запроса (Signature)
Формирование компактной сериализации JWS
JWS формируется из трех составляющих:
Base64Url(Header) || ’.’ || Base64Url(Payload) || ’.’ || Base64Url(Signature)
Signature — это подпись данных приватной частью ключевой пары клиента (используется приватный ключ парный сертификату клиента с UUID, указанному в Заголовке (Header) в параметре kid). Подпись вычисляется по алгоритму указанному в Заголовке (Header) в параметре alg, в данном случае gost34.10-2012, и вычисляется от исходных данных: Base64Url(Header) || ‘.’ || Base64Url(Payload).
Формирование исходных данных для вычисления подписи описано в спецификации RFC 7515: JSON Web Signature (JWS).
Следует отметить, что при кодировании JWS используется преобразование Base64Url, отличающееся от Base64 преобразования. Условно это преобразование можно представить следующим образом:
Base64Url(x) := Base64(x).Split(‘=’) [0] .Replace(‘+’, ’-’).Replace(‘/’, ’_’)
здесь функция Split(x), разбивает строку на части ( [i] означает взятие i–ой части), используя символ разделитель x, функция Replace(x,y) заменяет все вхождения символа x на символ y.
Преобразование BASE64URL, отличается от BASE64 преобразования:
- Используются другие вспомогательные символы Base 64 Encoding with URL and Filename Safe Alphabet.
| BASE64URL | BASE64 |
|---|---|
| — (minus) | + |
| _ (underline) | / |
- В BASE64URL не используется (опускается) padding, т.е. не добавляются знаки ‘=’ на конце закодированного содержимого Padding of Encoded Data.
В ответе на запрос сервер возвращает JSON-документ, который содержит реквизитный состав подготовленного черновика рублевого платежного поручения в статусе Создан.
Коды возврата
| Код возврата | Описание кода возврата | Причина возникновения |
|---|---|---|
| 200 (GET-запрос) | ОК | |
| 201 (POST-запрос) | CREATED | |
| Создан | ||
| 400 | DESERIALIZATION_FAULT | |
| Неверный формат запроса | Неверный формат запроса | |
| WORKFLOW_FAULT | ||
| Для внешнего сервиса недоступны операции по счету: 40702810ХХХХХХХХХХХХ | Для внешнего сервиса недоступны операции по счету: | |
| счет не добавлен в список разрешенных в оферте; | ||
| внешний сервис заблокирован в СББОЛ; | ||
| счет указан неверно. | ||
| Отсутствует доступный открытый рублевый расчетный счет у организации плательщика | ||
| Документ с такими реквизитами уже существует | Документ с такими реквизитами уже существует. Проверка по номер документа в течении года. | |
| Не указан идентификатор сертификата подписи | Не указан идентификатор сертификата подписи(параметр kid заголовка JWS) | |
| Некорректный формат параметра kid заголовка JWS | Некорректный формат параметра kid заголовка JWS(ожидается UUID) | |
| VALIDATION_FAULT | ||
| Ошибка валидации | Ошибка валидации данных запроса с указанием некорректных значений. Значения полей модели или параметров запроса не соответствуют допустимым и определенным в модели. | |
| SIGN_CHECK_EXCEPTION | ||
| Подлинность подписи не установлена/Сертификат не обнаружен или не является активным | Ошибка возникает, если не удалось установить подлинность подписи | |
| 401 | UNAUTHORIZED | |
| accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. | |
| 403 | ACTION_ACCESS_EXCEPTION | |
| Операция не может быть выполнена: доступ к ресурсу запрещен | У пользователя нет прав на использование соответствующего сервиса Sber API (Fintech API), доступ к которому не предусмотрен настройками scope; У пользователя отсутствует оферта с внешним сервисом. | |
| 404 | DATA_NOT_FOUND_EXCEPTION | |
| Платежный документ не найден | Неверное значение externalId | |
| 415 | JWS_EXCEPTED | |
| В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization | Ошибка возникает, если в настройках внешних сервисов выставлен флаг «Требуется подпись для внешнего сервиса» | |
| 500 | UNKNOWN_EXCEPTION | |
| Внутренняя ошибка сервера |
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.
Платежное поручение
Платежное поручение (платежка) – расчетный документ. Владелец счета (плательщик) посредством платежного поручения дает своему банку распоряжение перевести определенные денежные средства на счет получателя, открытый в этой или другой кредитной организации.
Платежными поручениями могут производиться:
— расчеты за поставленные товары, выполненные работы, оказанные услуги;
— перечисления денежных средств в бюджеты всех уровней и во внебюджетные фонды;
— перечисления денежных средств в целях возврата или размещения кредитов (займов) или депозитов и уплаты процентов по ним;
— перечисления денежных средств в других целях, предусмотренных законодательством или договором;
— предварительная оплата товаров, работ, услуг;
— осуществление периодических платежей.
Платежное поручение составляется клиентом на стандартном бланке формы 0401060. Стандарты платежного поручения, как и других расчетных документов, прописаны в «Положении о безналичных расчетах в РФ» ЦБ РФ № 2-П от 03 октября 2002 года, а с 9 июля 2012 года — в «Положении о правилах осуществления перевода денежных средств»; № 383-П от 19.06.2012 года.
Реквизиты платежного поручения
Платежное поручение должно содержать следующие реквизиты:
— наименование и номер платежного поручения, число, месяц и год его выписки;
— код формы по ОКУД ОК 011-93;
— наименование плательщика и получателя средств и их номера счетов;
— ИНН плательщика и получателя;
— наименование и местонахождение банка плательщика и получателя, их банковские идентификационные коды (БИК), номера корреспондентских счетов или субсчетов;
— назначение, сумма и очередность платежа;
— подписи уполномоченных лиц и оттиск печати (в установленных случаях).
Какие коды в платежном поручении?
В платежном поручении обычно указываются следующие коды:
— Код банка получателя (БИК)
— Номер счета получателя
— КПП получателя (для юридических лиц)
— Назначение платежа (код ОКАТО или ОКТМО для налоговых платежей, код услуги для коммунальных платежей и т.д.)
Какие поля должны быть заполнены в платежном поручении?
В платежном поручении необходимо указать следующие поля: наименование и ИНН получателя, номер счета получателя, БИК банка получателя, наименование банка получателя, назначение платежа, сумма платежа. Кроме того, также можно указать дополнительные данные, например, номер договора или код операции.
Банк не принимает к исполнению платежные поручения, не соответствующие требованиям, предусмотренным законом (ст. 864 ГК РФ). При оформлении платежного поручения нельзя допускать исправления и ошибки при заполнении реквизитов.
Количество оформляемых и предъявляемых в банк экземпляров платежного поручения определяется числом участников расчетов. На первом экземпляре, который остается в банке, наличие подписи и оттиска печати (при наличии) плательщика обязательно. На одном из экземпляров платежного поручения банк делает отметку об исполнении и возвращает его владельцу счета. Платежные поручения принимаются банком независимо от наличия денежных средств на счете плательщика. Банк полностью исполняет поручение, если на счете клиента достаточно денежных средств для осуществления платежа. При недостаточности средств на счете их списание происходит с соблюдением определенной в ст. 855 ГК РФ очередности. Такие платежные документы банк помещает в специальную картотеку по внебалансовому счету № 90902 «Расчетные документы, не оплаченные в срок».
Сколько действует платежное поручение?
Платежное поручение действительно к предъявлению в банк в течение 10 дней. Об исполнении поручения банк обязан проинформировать плательщика не позже следующего рабочего дня после его подачи в банк, если иной срок не предусмотрен договором банковского счета.
Платежное поручение может быть оформлено и в электронной форме через систему «Клиент-Банк». Для электронных платежных поручений, передаваемых по каналам связи, каждый банк самостоятельно определяет порядок оформления, приема и защиты.
Как проверить статус платежного поручения?
Для проверки статуса платежного поручения необходимо зайти в интернет-банк или мобильное приложение банка, выбрать соответствующий раздел и найти нужный платеж. В статусе платежа будет указано, был ли он успешно проведен или возникли какие-то ошибки. Если у вас возникнут вопросы, вы можете обратиться в службу поддержки банка для получения дополнительной информации.
Правила создания платежных поручений в системе Сбербанк Бизнес ОнЛайн
Для создания платежного поручения в системе Сбербанк Бизнес ОнЛайн:
- В форме списка платежных поручений нажмите кнопку панели инструментов.
- Откроется окно Платежное поручение. Примечание: Данное окно аналогично основной части окна Платежное поручение, аналогично заполняются и соответствующие поля этих двух окон (с той разницей, что при создании исходящего платежного требования Вы действуете от имени получателя, а не плательщика). Ряд полей окна уже будет заполнен системой Сбербанк Бизнес ОнЛайн. Поля с белым фоном заполняются или редактируются вручную. Поля с серым фоном заполняются либо пользователем путем выбора значений из списка, либо системой автоматически в процессе заполнения реквизитов документов.
Внимание!
- Выбор значений из справочников осуществляется при помощи кнопок и , добавление введенных значений в справочник – с помощью кнопки (см. «Выбор значений из справочника»).
- Выбор значений из выпадающих списков осуществляется с помощью кнопки (см. «Выбор значения из выпадающего списка»).
- Ввод дат осуществляется либо вручную, либо с помощью кнопки (см. «Выбор даты с помощью календаря»).
a. В поле Номер при необходимости измените номер документа. По умолчанию система нумерует документы по порядку создания в течение календарного года. Внимание! При сохранении документа система проверяет, не дублируется ли номер документа. Если в текущем году в системе уже был сохранен экземпляр такого же документа с таким же номером, формируемый документ будет сохранен с ближайшим большим свободным номером, и о новом номере будет выведено сообщение. b. В поле Дата при необходимости измените дату документа. По умолчанию поле заполняется текущей датой.
c. Если акцепт был оформлен плательщиком заранее, измените условие в поле Условие платы, выбрав из выпадающего списка значение «1 – Заранее данный акцепт». (Значение по умолчанию «2 – Требуется получение акцепта».)
d. При необходимости в поле Срок акцепта измените число рабочих дней, предоставляемое для акцепта.
e. В поле Вид платежа при необходимости измените способ отправки документа. Значение по умолчанию – «электронно».
- Выберите плательщика из справочника корреспондентов (доступен также поиск плательщика по значениям полей Плательщик и ИНН).
- Поля Банк плательщика, БИК, Сч. № (кор/счет банка плательщика), Плательщик, ИНН / КИО, Сч. № (счет плательщика) будут заполнены значениями из справочника.
Если плательщика нет в справочнике корреспондентов (новый плательщик), заполните соответствующие поля вручную:
- Введите данные о банке плательщика:
- В поле БИК введите или выберите из справочника БИК РФ значение БИК.
- Поля Банк Получателя и Сч. № (кор/счет банка плательщика) будут заполнены автоматически.
C. В блоке Получатель введите значения реквизитов получателя:
При необходимости измените данные о счете получателя:
- В поле Сч. № (счет получателя) измените номер счета (выберите из справочника счетов или введите вручную).
- Поля Получатель, Банк получателя, БИК, Сч. № (кор/счет банка получателя) будут заполнены автоматически.
- В поле Получатель при необходимости измените название организации.