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

История изменений

2026-05-21​

  • В методе add_beneficiary_documents_data:
    • Добавлено описание нового блока добавления документов для бенефициаров-нерезидентов в запросе и ответе.
    • Добавлены схемы определения состава документов для бенефициаров-нерезидентов.
    • Обновлён список возможных ошибок.
  • В методе get_beneficiary_documents_data добавлено описание нового блока получения документов для бенефициаров-нерезидентов в ответе.

2026-04-28​

  • В методе identification_payment:
    • Добавлено описание нового блока для работы с излишками excess_refund в запросе и ответе.
    • Обновлён список возможных ошибок.
  • В методе get_payment:
    • Добавлен новый тип платежа excess_refund.
    • Добавлено описание нового блока excess_refund для входящего платежа incoming, по которому был создан платёж излишка.
    • Добавлено описание нового поля parent_id для платежа с типом excess_refund.
  • В методах list_payments и list_payments_v2 добавлен новый тип платежа excess_refund.

2026-04-01​

  • Ужесточены правила валидации полей при создании бюджетных платежей. Платежи с некорректными полями будут отклонены с ошибкой 4002 и описанием проблемы.
  • Поле 101 (status):
    • Добавлен новый статус 34 для таможенных платежей.
    • Статус 20 запрещён.
    • Допустимые значения: 01, 02, 03, 04, 05, 06, 07, 08, 13, 15, 16, 17, 19, 20, 23, 24, 27, 28, 29, 30, 31, 32, 33, 34.
  • Поле 106 (base):
    • Добавлено новое значение ПР — решение таможенного органа на бесспорное взыскание.
    • Допустимые значения: 00, ПК, ПР, КЭ, УВ, ИЛ, ПБ, ТГ, ТБ, ТД, ПВ, ИН.
    • Значение 0 допустимо только для status=27 и отдельных счетов: ТОФК, ПБР, 03212-03244.
  • Поле 107 (field107):
    • Формат налогового периода МС.NN.YYYY больше не принимается.
    • Допустимые значения: 0 при КБК не 153 или код таможенного органа из 8 цифр при КБК 153.
  • Привязка статуса к счёту получателя:
    • 03100643000000018500 (ТОФК): 01, 04, 13, 15.
    • 03100* (другие): 03, 05, 06, 07, 08, 15, 16, 17, 19, 23, 24, 28, 29, 30, 32, 34.
    • 03212-03244: 03, 05, 08, 15, 19, 20, 24, 29, 33.
    • 40204810800000950001 (ПБР): 01, 04, 13, 15.
    • Статусы 01 и 13 при корсчёте 40102 должны направляться строго на счёт 03100643000000018500.
  • Поле 109 (document_date в tax_fields): значение 0 допустимо только для счетов ТОФК (03100643000000018500) и ПБР (40204810800000950001).
  • Поле 108 (document_number) для счетов 03212-03244:
    • При status 03, 19, 20, 24: ИНН 5 или 10 знаков — document_number не может быть 0; ИНН 12 знаков — 0 допустим.
    • Формат: ТИП;НОМЕР, где ТИП — 01-14, 22, 24-26, 28-30, а НОМЕР — 1-12 символов без - и №.

2026-03-25​

  • Добавлено описание нового формата ошибок и коды ошибок к методам create_beneficiary, add_beneficiary_documents_data, get_beneficiary_documents_data.
  • Дополнено описание метода get_beneficiary_documents_data.
  • Исправлены типы исходящих параметров метода list_virtual_transaction.
  • Исправлены опечатки в параметрах метода add_beneficiary_documents_data.
Важно

Методы create_beneficiary_fl, update_beneficiary_fl, create_beneficiary_ip, update_beneficiary_ip планируется отключить в будущем. Рекомендуем использовать актуальные альтернативные запросы.

2025-12-26​

  • Для регистрации ИП и физлиц добавлен новый метод create_beneficiary. Для юрлиц продолжает использоваться create_beneficiary_ul.
  • Добавлен метод add_beneficiary_documents_data для загрузки документов бенефициара и обновления его данных с валидацией через СМЭВ.

2025-12-05​

  • Добавлены валидации поля «Место рождения»:
    • create_beneficiary_fl: beneficiary_data.birth_place
    • update_beneficiary_fl: beneficiary_data.birth_place

2025-12-01​

  • Добавлены валидации поля «Дата налогового документа» для платежей в бюджет:
    • payment_of_taxes при recipients.type=ndfl_from_virtual_account: recipients[].tax_fields.document_date
    • create_deal при recipients.type=ndfl: recipients[].tax_fields.document_date

2025-09-09​

  • Появились выплаты на бизнес‑карты ИП и юрлицам с помощью метода create_deal.
  • Добавлено необязательное поле recipients.payment_contract_to_card.purpose — назначение платежа при таких выплатах, максимум 50 символов.

2025-09-01​

  • В методы create_beneficiary_fl, update_beneficiary_fl, create_beneficiary_ip, update_beneficiary_ip добавлено поле beneficiary_data.tax_resident.
  • В методы create_beneficiary_ul и update_beneficiary_ul добавлено поле beneficiary_data.is_active_activity.

2025-08-04​

  • Добавлена валидация на количество знаков после запятой (не более 2):
    • Методы и поля:
      • refund_virtual_account: recipient.amount
      • refund_payment: amount, virtual_accounts[].amount, purpose_nds
      • identification_payment: owners[].amount
      • create_deal: amount, payers[].amount, recipients[].amount, recipients[].purpose_nds
      • update_deal: amount, payers[].amount, recipients[].amount, recipients[].purpose_nds
      • payment_of_taxes: amount, payer.amount, recipients[].amount, recipients[].purpose_nds
      • compliance_check_payment: amount
      • sbp_gen_qr_code: amount
      • transfer_between_virtual_accounts: amount
      • transfer_between_virtual_accounts_v2: amount
    • Пример ошибки (для разных методов и полей формат может отличаться):
      • {"code": 4002, "message": "No valid data in request", "meta": [{"amount": ["The input value 100.0033 has too many decimal places: 4. Maximum allowed is 2"]}]}

2024-11-25​

  • Добавлен новый метод get_beneficiary_restrictions.

2024-11-13​

  • В методы create_deal, update_deal, payment_of_taxes добавлена валидация символов для полей name и purpose. Поля могут содержать только символы, удовлетворяющие регулярному выражению [ -~№А-яёЁ\t\n\r].

2024-10-28​

  • На слое pre время на идентификацию уменьшено с 72 часов до 30 минут (для ускорения тестирования).

2024-06-27​

  • Добавлено ограничение в 1000 элементов в list_* методах с пагинацией. Затрагивает методы:
    • list_beneficiary
    • list_virtual_account
    • list_virtual_transaction
    • list_payments
    • list_payments_v2
    • list_deal
    • list_deals
    • list_documents

2024-06-27​

  • Добавлен новый тип ошибок: 4558: It is impossible to perform the operation due to the fact that restrictions are imposed on the beneficiary based on the writ of execution. Ошибка возникает при попытке использовать средства бенефициара под арестом (обычно на основании постановлений ФССП). Затрагивает методы:
    • create_deal
    • update_deal
    • payment_of_taxes
    • refund_payment (в случае возврата идентифицированного СБП‑платежа)
    • refund_virtual_account
    • transfer_between_virtual_accounts_v2
    • transfer_between_virtual_accounts
    • execute_deal

2024-05-17​

  • Добавлен новый тип платежа: инкассовый платёж (collection_order). Методы:
    • get_payment
    • list_payments
    • list_payments_v2

2024-05-15​

  • Добавлен новый тип ошибок: 4451: The purpose of the non-resident's payment contains incorrect or missing VO codes. Ошибка возникает при попытке вывести средства с нерезидентского н/с без кодов ВО. Методы:
    • create_deal
    • update_deal
    • payment_of_taxes
    • refund_virtual_account
    • refund_payment

2024-04-15​

  • В методах create_deal, update_deal, payment_of_taxes, refund_virtual_account для выплат по СБП, картам и реквизитам появились новые необязательные параметры:
    • identifier (для карт, СБП и выплат по реквизитам)
    • inn (только для карт и СБП)
    • recipient_fio (только для карт)

2024-04-11​

  • В метод list_payments добавлен фильтр по c2b_qr_code_id.

2024-04-10​

  • В методе get_beneficiary появилось новое поле в ответе — ogrn. В create_beneficiary_ul и update_beneficiary_ul добавилось необязательное поле ogrn.

2024-03-14​

  • В методе get_deal появилось новое поле в ответе — recipient.payment.meta. В это поле добавляется уникальный идентификатор rnn карточного платежа, который помогает при поиске платежа у банка получателя.

2024-02-23​

  • В методе get_deal появилось новое поле в ответе — recipient.status.

2024-02-06​

  • В методе get_deal появилось новое поле в ответе — ext_key.

2024-02-05​

  • В методах, связанных с бенефициаром, прекращена поддержка необязательного параметра ИНН: используйте beneficiary_id. Также удалены необязательные параметры nominal_account_code и nominal_account_bic в методах update_beneficiary_*, get_beneficiary, deactivate_beneficiary, activate_beneficiary.

2024-02-05​

  • В методах refund_payment, create_deal, refund_virtual_account для поля document_number добавлено ограничение на количество символов (до 6).