Scope
payment-registries
Текущий метод больше не будет поддерживаться в связи с развитием функционала сервиса. Для продолжения работы с методом необходимо перейти на новый метод для создания реестра рублёвых платежей.
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow / Authorization Code Flow H2H
application/json
application/json
Код срочности:
-
•
OFFHOURS- продлённый операционный день; -
•
BESP- срочный платёж; -
•
NORMAL- стандартный операционный день
Описание реестра
Данные рублёвого платёжного поручения
Номер документа
Дата составления документа
Вид платежа
Сумма платежа
Полное наименование плательщика
ИНН плательщика
КПП плательщика
Счёт плательщика
БИК банка плательщика
Корсчёт банка плательщика
Полное наименование получателя платежа
ИНН получателя платежа
КПП получателя платежа
Счёт получателя платежа
БИК банка получателя платежа
Корсчёт банка получателя платежа
Реквизиты налогового, таможенного или иного бюджетного платежа
Уникальный идентификатор платежа/начисления
Статус плательщика
Код бюджетной классификации
Код OKTMO
Показатель основания платежа
Налоговый период или код таможенного органа
Номер налогового документа
Дата налогового документа в формате YYYY-MM-DD
Код выплат
Код вида дохода получателей выплаты по 229-ФЗ. При значениях 1, 3, 5 в назначении платежа следует указать сумму взыскания в формате //ВЗС//сумма-копейки//, где сумма-копейки - это сумма взыскания.
Пример при сумме взыскания в пять тысяч рублей: //ВЗС//5000-00//
Очерёдность платежа. Возможные значения:
-
•
1- алиментные удержания из заработной платы, компенсации вреда жизни и здоровью; -
•
2- погашение задолженностей по зарплатам сотрудникам, выплаты выходных пособий и авторских вознаграждений; -
•
3- выплаты зарплат сотрудникам по трудовым соглашениям, принудительная уплата налогов и отчислений во внебюджетные фонды; -
•
4- принудительные выплаты, которые не вошли в первую, вторую и третью очередь, например, задолженности по договорам, штрафы, неустойки, коммунальные платежи; -
•
5- все остальные, не вошедшие в первую, вторую, третью и четвёртую категории, например, добровольная уплата долгов, пеней, штрафов
Значение по умолчанию 5
Назначение платежа. Максимальное количество символов - 210.
В случае оплаты за третье лицо в начале строки необходимо указать:
-
•ИНН и КПП (при наличии) владельца счёта (плательщика);
-
•Наименование налогоплательщика, плательщика сборов, страховых взносов и иных платежей (третьего лица).
Для разделения информации об ИНН, КПП клиента и о налогоплательщике от иной информации, указываемой в реквизите, используйте символы //
1curl --location 'https://baas.alfabank.ru/api/jp/v2/payments/registries' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6 "urgencyCode": "NORMAL",
7 "description": "Описание реестра",
8 "payments": [
9 {
10 "number": "1",
11 "date": "2023-12-31",
12 "deliveryKind": "электронно",
13 "amount": 1.01,
14 "payerName": "Общество с ограниченной ответственностью \"Клиент\"",
15 "payerInn": "7736576798",
16 "payerKpp": "772201001",
17 "payerAccount": "40702810600010800068",
18 "payerBankBic": "044525593",
19 "payerBankCorrAccount": "30101810200000000593",
20 "payeeName": "Общество с ограниченной ответственностью \"Центр \"ИННОВАЦИЯ\"",
21 "payeeInn": "7723870785",
22 "payeeKpp": "553453453",
23 "payeeAccount": "40702810564564564531",
24 "payeeBankBic": "040173745",
25 "payeeBankCorrAccount": "30101810800000000745",
26 "departmentalInfo": {
27 "uip": "0",
28 "drawerStatus101": "01",
29 "kbk": "18210102010011000110",
30 "oktmo": "45902000",
31 "reasonCode106": "ТП",
32 "taxPeriod107": "ГД.00.2021",
33 "docNumber108": "000000000000001",
34 "docDate109": "2021-12-14",
35 "paymentKind110": "0"
36 },
37 "incomeTypeCode": "2",
38 "priority": "5",
39 "purpose": "1234567890//123456789//Иванов Иван Иванович оплата по договору 1. НДС не облагается"
40 }
41 ]
42}'Параметры ответа
1{
2 "registryId": "U102702240001212",
3 "description": "Описание реестра",
4 "payerAccount": "40702810600010800068",
5 "urgencyCode": "NORMAL",
6 "paymentsCount": 2,
7 "totalAmount": 100
8}Идентификатор реестра
Описание реестра
Счёт списания
Срочность платежей в реестре
Количество платежей реестра
Общая сумма платежей в реестре
1{
2 "registryId": "U102702240001212",
3 "description": "Описание реестра",
4 "payerAccount": "40702810600010800068",
5 "urgencyCode": "NORMAL",
6 "paymentsCount": 2,
7 "totalAmount": 100
8}Код ошибки. Принимает возможные значения:
-
•
invalid_request- неверные входные параметры запроса
Описание ошибки
1{
2 "error": "invalid_request",
3 "error_description": "Authorization header is not present in request headers"
4}Код ошибки. Принимает возможные значения:
-
•
invalid_token- предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам. При истечении срока жизни токена необходимо обновить его с помощьюrefresh_token. При отзыве токена необходимо заново пройти авторизацию
Описание ошибки
1{
2 "error": "invalid_token",
3 "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}Код ошибки. Принимает возможные значения:
-
•
insufficient_scope- при запросе кода авторизации не были переданы все необходимые scopes. Необходимо переподписать договор согласия, повторно отправив запрос на получение кода авторизации с указанием всех доступных scopes и параметраprompt=consent
Описание ошибки
1{
2 "error": "insufficient_scope",
3 "error_description": "The request requires higher privileges than provided by the access token"
4}Код ошибки. Принимает возможные значения:
-
•
unknown_endpoint- эндпоинт не найден или неактивен
Описание ошибки
1{
2 "error": "unknown_endpoint",
3 "error_description": "Endpoint is not found or not active"
4}Код ошибки. Принимает возможные значения:
-
•
internal_error- внутренняя ошибка сервиса при выполнении обработки запроса
Описание ошибки
1{
2 "error": "internal_error",
3 "error_description": "Internal server error"
4}