ym88659208ym87991671
Выставление счета клиенту | Документация SmartMarket
Skip to main content

Выставление счета клиенту

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

  • Тестовый контур https://edupirfintech.sberbank.ru:9443

  • Промышленный контур https://fintech.sberbank.ru:9443

Выставление счета клиенту для Сбербанка

Ресурс /v1/payments/from-invoice позволяет Партнеру выставлять клиенту счета - платежные документы с фиксированным сроком действия, в которых клиент не имеет возможности изменить сумму оплаты и реквизиты получателя. На основании выставленных счетов формируются платежные поручения. Отправка /v1/payments/from-invoice возможна только на счет Сбербанка и только на счет, который принадлежит организации.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

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

4. Получить статус.

5. Получить документ (опционально).

Для создания счета на оплату необходимо отправить POST-запрос (/v1/payments/from-invoice), в котором передать авторизационный токен к данным клиента (Access Token) и реквизиты счета. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU_INVOICE.

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token организации-клиента, полученный через SSO.
Пример: Bearer f8ad3141-b7e8-4924-92de-3de4fd0a464e-1
Параметры тела запроса
Invoice {
amount (number)Сумма платежа ,
bankComment (string, optional, read only)Банковский комментарий к статусу документа ,
bankStatus (string, optional, read only)Статус документа ,
crucialFieldsHash (string, optional, read only)Hash от ключевых полей документа ,
date (string)Дата составления документа ,
deliveryKind (string, optional)Вид платежа ,
expirationDate (string, optional)Дата истечения заказа (платеж должен быть подтвержден клиентом) ,
externalId (string)Идентификатор документа, присвоенный партнером (UUID) ,
operationCode (string, optional)Код операции ,
orderNumber (string, optional)Номер заказа ,
payeeAccount (string)Счет получателя платежа ,
payeeOrgIdHash (string, optional)Идентификатор получателя платежа ,
paymentNumber (string, optional)Номер платежного поручения.
Если клиент не ведет в своей учетной системе нумерацию платежных поручений, созданных на основании выставленных счетов, то атрибут можно не передавать, он будет присвоен автоматически ,
priority (string, optional)Очередность платежа ,
purpose (string)Назначение платежа ,
urgencyCode (string, optional)Код срочности = [INTERNAL - срочный, INTERNAL_NOTIF - срочный платеж с уведомлением,
OFFHOURS - неотложный, BESP - банковские электронные срочные платежи, NORMAL - срочность не указана]
stringEnum : 0, 1, 2, 3, 4,
vat (Vat, optional)Данные НДС ,
}Vat {
amount (number, optional)Сумма НДС ,
rate (string, optional)Ставка НДС ,
type (string)Способ расчета НДС = [INCLUDED - НДС включен в сумму платежа, NO_VAT - не облагается НДС, MANUAL - ручной ввод НДС]
stringEnum: 0, 2, 3
}

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

{
"amount":1.01,
"bankComment":"string",
"bankStatus":"CREATE",
"date":"2018-12-31",
"deliveryKind":"электронно",
"expirationDate":"2019-01-01",
"externalId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
"operationCode":"01",
"orderNumber":"123",
"payeeAccount":"40802810600000200000",
"payeeOrgIdHash":"ee0fb56b01a9d9b9648a2c60549b77702eb2a6de8f2189c4349447e43b250da5",
"paymentNumber":"1",
"priority":"5",
"purpose":"Оплата заказа №123. НДС нет.",
"urgencyCode":"INTERNAL",
"vat":{
"amount":0.00,
"rate":"0",
"type":"NO_VAT"
}
}
danger

Если требуется проверить неизменность реквизитов получателя платежа, до получения выписки с информацией о проведенном документе, необходимо сравнить хэш реквизитов получателя (crucialFieldsHash), полученные при создании черновика документа, с crucialFieldsHash полученным при запросе статуса документа. Для вычисления значения хэша ключевых полей формируется строка из реквизитов, соединенных между собой: БИК банка получателя, счет получателя платежа, сумма платежа, (разделитель-точка).

Выставление счета клиенту для любого банка

Ресур /v1/payments/from-invoice-any позволяет Партнеру выставлять счет на оплату в адрес клиентов как Сбербанка, так и любого другого банка. На основании выставленных счетов формируются платежные поручения.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

3. Получить статус.

4. Получить документ.

Для создания счета на оплату необходимо отправить POST-запрос (/v1/payments/from-invoice-any), в котором необходимо передать авторизационный токен для получения доступа к данным клиента (Access Token) и реквизитный состав счета. Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU_INVOICE_ANY.

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token организации-клиента, полученный через SSO
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Параметры тела запроса
InvoiceAny {
amount (number)Сумма платежа,
creditContractNumber (string, optional)Номер кредитного договора,
date (string)Дата составления документа,
deliveryKind (string, optional)Вид платежа,
expirationDate (string, optional)Дата истечения заказа (платеж должен быть подтвержден клиентом),
externalId (string)Идентификатор документа, присвоенный партнером (UUID),
isPaidByCredit (boolean, optional)Признак того, что платежное поручение будет оплачено за счет кредитных средств,
linkedDocs (Array[LinkedDoc], optional)Связанные документы,
operationCode (string, optional)Код операции,
orderNumber (string, optional)Номер заказа,
payeeAccount (string)Счет получателя платежа,
payeeBankBic (string)БИК банка получателя платежа,
payeeBankCorrAccount (string, optional)Кор. счет банка получателя платежа,
payeeInn (string)ИНН получателя платежа,
payeeKpp (string, optional)КПП получателя платежа,
payeeName (string)Наименование получателя платежа,
paymentNumber (string, optional)Номер платежного поручения,
priority (string, optional)Очередность платежа,
purpose (string)Назначение платежа,
urgencyCode (string, optional)Код срочности = [INTERNAL, INTERNAL_NOTIF, OFFHOURS, BESP, NORMAL]
stringEnum : 0, 1, 2, 3, 4,
vat (Vat, optional)Данные НДС
}
LinkedDoc {docExtId (string)Идентификатор документа во внешней системе (UUID),
docExtId (string)Идентификатор документа во внешней системе (UUID),
type (string)Тип связанного документа
}
Vat {
amount (number, optional)Сумма НДС,
rate (string, optional)Ставка НДС,
type (string)Способ расчета НДС = [INCLUDED, ONTOP, NO_VAT, MANUAL]
}

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

{
"amount": 1.01,
"creditContractNumber": "2020/66556",
"date": "2018-12-31",
"deliveryKind": "электронно",
"expirationDate": "2018-12-31",
"externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
"isPaidByCredit": true,
"linkedDocs": [
{
"docExtId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
"type": "PayDocCur"
}
],
"operationCode": "01",
"orderNumber": "123",
"payeeAccount": "40802810600000200000",
"payeeBankBic": "044525225",
"payeeBankCorrAccount": "30101810400000000225",
"payeeInn": "7707083893",
"payeeKpp": "222201001",
"payeeName": "Общество с ограниченной ответственностью \"Клиент\"",
"paymentNumber": "1",
"priority": "5",
"purpose": "Оплата заказа №123. НДС нет.",
"urgencyCode": "INTERNAL",
"vat": {
"amount": 1.01,
"rate": "10",
"type": "NO_VAT"
}
}

Модель ответа

НаименованиеОписание
Payment {
amount (number)Сумма платежа,
bankComment (string, optional, read only)Банковский комментарий к статусу документа,
bankStatus (string, optional, read only)Статус документа,
crucialFieldsHash (string, optional)Hash от ключевых полей документа,
date (string)Дата составления документа,
deliveryKind (string, optional)Вид платежа,
departmentalInfo (DepartmentalInfo, optional)Реквизиты налогового, таможенного или иного бюджетного платежа,
digestSignatures (Array[Signature], optional)Электронные подписи по дайджесту документа,
externalId (string)Идентификатор документа, присвоенный партнером (UUID),
incomeTypeCode (string, optional)Код вида дохода получателей выплаты по 229-ФЗ,
number (string, optional)Номер документа,
operationCode (string)Код операции,
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)
purpose (string)Назначение платежа,
urgencyCode (string, optional)Код срочности = [INTERNAL, INTERNAL_NOTIF, OFFHOURS, BESP, NORMAL],
vat (Vat, optional)Данные НДС,
voCode (string, optional)Код вида валютной операции
}
DepartmentalInfo {
uip (string)Уникальный идентификатор платежа,
drawerStatus101 (string)Показатель статуса налогоплательщика (реквизит - 101),
kbk (string)Код бюджетной классификации (реквизит - 104),
oktmo (string)Код OKTMO (реквизит - 105),
reasonCode106 (string)Показатель основания платежа (реквизит - 106),
taxPeriod107 (string)Налоговый период / код таможенного органа (реквизит - 107),
docNumber108 (string)Номер налогового документа (реквизит - 108)
Должно быть проставлено значение: 0 или пустое или цифровое,,
docDate109 (string)Дата налогового документа (реквизит - 109),
paymentKind110 (string, optional)Тип налогового платежа (реквизит - 110)
}
Signature {
base64Encoded (string)Значение электронной подписи, закодированное в Base64,
certificateUuid (string)Уникальный идентификатор сертификата ключа проверки электронной подписи (UUID)
}
Vat {
amount (number, optional)Сумма НДС,
rate (string, optional)Ставка НДС,
type (string)Способ расчета НДС = [INCLUDED, ONTOP, NO_VAT, MANUAL]}

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

{
"amount": 1.01,
"bankComment": "string",
"bankStatus": "string",
"crucialFieldsHash": "string",
"date": "2018-12-31",
"deliveryKind": "электронно",
"departmentalInfo": {
"uip": "0",
"drawerStatus101": "01",
"kbk": "18210102010011000110",
"oktmo": "01701000",
"reasonCode106": "ТП",
"taxPeriod107": "ГД.00.2018",
"docNumber108": "123",
"docDate109": "0",
"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": 1.01,
"rate": "10",
"type": "NO_VAT"
},
"voCode": "61150"
}
danger

Если требуется проверить неизменность реквизитов получателя платежа, до получения выписки с информацией о проведенном документе, необходимо сравнить хэш реквизитов получателя (crucialFieldsHash), полученные при создании черновика документа, с crucialFieldsHash полученным при запросе статуса документа. Для вычисления значения хэша ключевых полей формируется строка из реквизитов, соединенных между собой: БИК банка получателя, счет получателя платежа, сумма платежа, (разделитель-точка).

Выставление счета в бюджет

Ресурс v1/payments/from-invoice-budget позволяет Партнеру выставлять счет в бюджет, с целью предоставить клиентам сервис по оплате налоговых платежей. На основании выставленных счетов формируются платежные поручения.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

3. Получить статус.

4. Получить документ.

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

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис PAY_DOC_RU_INVOICE_BUDGET.

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

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token организации-клиента, полученный через SSO
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Параметры тела запроса
Invoice {
amount (number)Сумма платежа ,
bankComment (string, optional, read only)Банковский комментарий к статусу документа ,
bankStatus (string, optional, read only)Статус документа ,
crucialFieldsHash (string, optional, read only)Hash от ключевых полей документа ,
date (string)Дата составления документа ,
deliveryKind (string, optional)Вид платежа
expirationDate (string, optional)Дата истечения заказа (платеж должен быть подтвержден клиентом) ,
externalId (string)Идентификатор документа, присвоенный партнером (UUID) ,
operationCode (string, optional)Код операции
orderNumber (string, optional)Номер заказа ,
payeeAccount (string)Счет получателя платежа ,
payeeOrgIdHash (string, optional)Идентификатор получателя платежа ,
paymentNumber (string, optional)Номер платежного поручения.
Если клиент не ведет в своей учетной системе нумерацию платежных поручений, созданных на основании выставленных счетов, то атрибут можно не передавать, он будет присвоен автоматически ,
priority (string, optional)Очередность платежа
purpose (string)Назначение платежа ,
urgencyCode (string, optional)Код срочности = [INTERNAL - срочный, INTERNAL_NOTIF - срочный платеж с уведомлением,
OFFHOURS - неотложный, BESP - банковские электронные срочные платежи, NORMAL - срочность не указана]stringEnum
vat (Vat, optional)Данные НДС
}Vat {
amount (number, optional)Сумма НДС ,
rate (string, optional)Ставка НДС
type (string)Способ расчета НДС = [INCLUDED - НДС включен в сумму платежа, NO_VAT - не облагается НДС, MANUAL - ручной ввод НДС]
stringEnum: 0,2,3 ,
}

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

{
"amount":1.01,
"bankComment":"string",
"bankStatus":"CREATE",
"date":"2018-12-31",
"deliveryKind":"электронно",
"departmentalInfo":{
"uip":"0",
"drawerStatus101":"01",
"kbk":"18210102010011000110",
"oktmo":"01701000",
"reasonCode106":"ТП",
"taxPeriod107":"ГД.00.2018",
"docNumber108":"123",
"docDate109":"0",
"paymentKind110":"1"
},
"externalId":"22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
"operationCode":"01",
"payeeAccount":"40802810600000200000",
"payeeBankBic":"044525225",
"payeeBankCorrAccount":"30101810400000000225",
"payeeInn":"7707083893",
"payeeKpp":"222201001",
"payeeName":"Общество с ограниченной ответственностью \"Клиент\"",
"payerKpp":"222201002",
"paymentNumber":"1",
"priority":"5",
"purpose":"Оплата заказа №123. НДС нет.",
"urgencyCode":"INTERNAL",
"vat":{
"amount":0.00,
"rate":"0",
"type":"NO_VAT"
}
}
danger

Если требуется проверить неизменность реквизитов получателя платежа, до получения выписки с информацией о проведенном документе, необходимо сравнить хэш реквизитов получателя (crucialFieldsHash), полученные при создании черновика документа, с crucialFieldsHash полученным при запросе статуса документа. Для вычисления значения хэша ключевых полей формируется строка из реквизитов, соединенных между собой: БИК банка получателя, счет получателя платежа, сумма платежа, (разделитель-точка).

Получение статуса черновика

Ресурс /v1/payments/{externalId}/state позволяет Партнеру получить статус ранее отправленного черновика. В случае если у клиента отключена/истек срок соглашения услуга на формирование платежных поручений, организация предоставляющая сервис может получить статус готовых документов.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для получения статуса необходимо отправить GET-запрос (/v1/ payments/{externalId}/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Запрошен отзывДокумент отозван
REFUSED_BY_RZKОтказан контролирующей организациейЭлектронный документ не прошел проверки контролирующей организацией
RZK_SIGN_ERRORОшибка ЭП СБКПроверка подписи под ЭД на стороне СБК дала отрицательный результат
SENDING_TO_RZKОтправляется в СБКЭлектронный документ отправлен в СБК, но не получен квиток о доставке
SIGNEDПодписанЭД подписан предусмотренным для него комплектом подписей.
TO_PROCESSING_RZKК отправке в СБКЭД подписан предусмотренным для него комплектом о доставке
Окончательный/Прекратить опрос
DELETEDУдаленЭлектронный документа удален из числа действующих документов
INVALIDEDSЭП/АСП не вернаПроверка ЭП под ЭД на стороне Банка дала отрицательный результат
RECALLОтозванЭлектронный документ был отозван Клиентом по запросу
REFUSEDBYBANKОтвергнут банкомЭлектронный документ отвергнут банком
REFUSEDBYABSОтказан АБСЭлектронный документ не прошел проверки в АБС
REQUISITEERRORОшибка реквизитовВ ЭД указаны ошибочные реквизиты
Окончательный(Успешный)/Прекратить опрос
IMPLEMENTEDИсполненЭлектронный документ исполнен Банком

Получение атрибутов поручения

Ресурс /v1/payments/{externalId} позволяет Партнеру получить атрибуты ранее отправленного рублевого платежного поручения.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для получения платежного документа необходимо отправить GET-запрос (/v1/payments/{externalId}), в котором необходимо передать авторизационный токен к данным клиента (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'

Модель ответа

Соответствует модели запроса и ответа /v1/payments.

Дополнительная информация

Правила формирования ссылки

Ссылка для переадресации клиента на форму оплаты должна состоять из нескольких частей:

  • Адрес стенда банка, например: https://edupirfintech.sberbank.ru:9443.
    Для клиентов, которые используют устройство защиты, хост заменяется на локальный адрес устройства, например: http://localhost:28016.

  • Адрес сформированного по запросу платежного поручения с указанием внутреннего идентификатора документа (externalId), например: #/payment-creator/externalId={docExtId}

  • Адрес страницы для возврата клиента со страницы платежного поручения, например: &backUrl=https://egazin.ru/paypage/1234567890/success.
    При передаче backUrl необходимо делать URLEncode.
    Параметр backUrl является необязательным и в случае его отсутствия в ссылке клиент не сможет вернуться в сервис Партнера.
    Параметр backUrl должен соответствовать адресу сервиса Партнера, указанному при регистрации в банке.


Пример ссылки для переадресации клиента на форму оплаты:

https://edupirfintech.sberbank.ru:9443/icdk/dcb/index.html#/payment-creator/ef4cbd04-40c2-4315-ae1a-602b52a6ab4f?backUrl=https://egazin.ru/paypage/1234567890/success

Параметры НДС

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

  • Если блок vat не указан, то по умолчанию будут присвоены и придут в ответе на запрос следующие значения :
"vat": {
"type": "NO_VAT",
"rate": "0",
"amount": "0.00"
}
note

В поле "Назначение платежа" необходимо обязательно отправлять "НДС не облагается".

  • При выбранном "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 преобразования:

BASE64URLBASE64
- (minus)+
_ (underline)/
  • В BASE64URL не используется (опускается) padding, т.е. не добавляются знаки ‘=’ на конце закодированного содержимого Padding of Encoded Data.

В ответе на запрос сервер возвращает JSON-документ, который содержит реквизитный состав подготовленного черновика рублевого платежного поручения в статусе Создан.

Коды возврата

Код возвратаОписание кода возвратаПричина возникновения
201 (POST-запрос)CREATED
Создан
202 (POST-запрос)SC_ACEPTED
Операция не завершена полностьюДокумент создан, сохранен но не подписан Банком
400DESERIALIZATION_FAULT
Неверный формат запросаНеверный формат запроса
WORKFLOW_FAULT
Для внешнего сервиса недоступны операции по счету: 40702810ХХХХХХХХХХХХДля внешнего сервиса недоступны операции по счету:

счет не добавлен в список разрешенных в оферте;
внешний сервис заблокирован в СББОЛ;
счет указан неверно.

Отсутствует доступный открытый рублевый расчетный счет у организации плательщика
Документ с такими реквизитами уже существуетДокумент с такими реквизитами уже существует. Проверка по номер документа в течении года.
Не указан идентификатор сертификата подписиНе указан идентификатор сертификата подписи(параметр kid заголовка JWS)
Некорректный формат параметра kid заголовка JWSНекорректный формат параметра kid заголовка JWS(ожидается UUID)
VALIDATION_FAULT
Ошибка валидацииОшибка валидации данных запроса с указанием некорректных значений. Значения полей модели или параметров запроса не соответствуют допустимым и определенным в модели.
SIGN_CHECK_EXCEPTION
Подлинность подписи не установлена/Сертификат не обнаружен или не является активнымОшибка возникает, если не удалось установить подлинность подписи
401UNAUTHORIZED
accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token.
403ACTION_ACCESS_EXCEPTION
Операция не может быть выполнена: доступ к ресурсу запрещенУ пользователя нет прав на использование соответствующего сервиса SberBusinessAPI, доступ к которому не предусмотрен настройками scope; У пользователя отсутствует оферта с внешним сервисом.
404DATA_NOT_FOUND_EXCEPTION
Платежный документ не найденНеверное значение externalId
415JWS_EXCEPTED
В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact SerializationОшибка возникает, если в настройках внешних сервисов выставлен флаг "Требуется подпись для внешнего сервиса"
500UNKNOWN_EXCEPTION
Внутренняя ошибка сервера
Обновлено 26 апреля 2022

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней