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

Объекты

AccountDetails​

Объект с информацией о счетах отправителя и получателя.

НазваниеОбязательностьТипОписание
sender+NominalPaymentParticipantИнформация о счете отправителя
recipient+NominalPaymentParticipantИнформация о счете получателя

AccountStatement​

Объект с деталями выписки.

НазваниеОбязательностьТипОписание
date_from+dateДата начала выписки
date_to+dateДата окончания выписки
account_number+stringНомер счёта (20 цифр), по которому сформирована выписка

AcquiringPayment​

Объект со всеми данными платежа.

НазваниеОбязательностьТипОписание
id+stringУникальный идентификатор платежа
status+stringСтатус платежа. Возможные варианты: succeeded, in_progress, pending, failed
created_at+stringДата создания в формате ISO 8601
payment_details+PaymentDetailsПлатежные данные
amount_details+AmountDetailsСумма
amounts-AmountsКомиссия за операцию
finished_at-stringДата завершения в формате ISO 8601
customer+CustomerДанные пользователя (отправителя платежа)
recurrent-RecurrentTokenInfoДанные для проведения повторного платежа
participant_details-ParticipantDetailsДанные об участниках
refunds-array[Refund]Список возвратов
customer_interaction-CustomerInteractionДанные для взаимодействия с пользователем
transaction_info-TransactionInfoДанные о транзакции
metadata-objectДополнительная информация. Любые данные, которые вам необходимы для проведения операции. Возвращаются в ответах и вебхуках
error-ErrorОписание ошибки
 

Статусы платежа (status)​

  • in_progress — в обработке.
  • pending — ожидает вашего подтверждения (confirm_request) или отмены (cancel_request).
  • succeeded — оплата прошла успешно.
  • failed — оплата не прошла из-за ошибки.

AcquiringWidgetMetadata​

Объект с настройками виджета платежной формы: для проведения платежей банковской картой.

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии, по которой будет производиться оплата
show_recurrent_checkbox-boolНужно ли отображать в интерфейсе виджета чекбокс Соглашаюсь на автоплатежи
success_return_url-stringURL, на который нужно перенаправить пользователя после успешного платежа
failure_return_url-stringURL, на который нужно перенаправить пользователя после ошибки при оплате
success_on_hold-boolНужно ли показывать плательщику сообщение об успешном платеже на этапе холдирования. По умолчанию false и виджет показывает экран загрузки до завершения холда

AmountDetails​

Объект суммы.

НазваниеОбязательностьТипОписание
amount+intЗначение суммы в минорных единицах валюты (в копейках). Чтобы передать 100 рублей, укажите 10000
currency+stringКод валюты согласно ISO 4217. Регистр не важен. Варианты: rub, eur

Amounts​

Объект c информацией о комиссии за транзакцию.

НазваниеОбязательностьТипОписание
fee-MerchantFeeДанные о взимаемой комиссии

BalanceDetails​

Информация о балансе счета.

НазваниеОбязательностьТипОписание
current_balance-stringТекущий остаток по счету (Может быть положительным или равным 0). Значение указывается в минорных единицах валюты (в копейках). Если баланс 100 рублей, передается 10000

BankAccountPaymentMethod​

Объект с описанием банковского счета получателя выплаты.

НазваниеОбязательностьТипОписание
system_type+stringСистема банковских платежей. Варианты: ru, faster_payment_system, faster_payment_system_verification
ru-BankAccountRUСчет получателя в российском банке (регион ru)
faster_payment_system-FasterPaymentSystemДанные получателя в Системе быстрых платежей
faster_payment_system_verification-FasterPaymentSystemVerificationДанные для проверки регистрации получателя в Системе быстрых платежей

BankAccountRU​

Объект с данными банковского счета в российском банке (в регионе ru).

НазваниеОбязательностьТипОписание
bik- (обязательно при выплатах без токена)stringБИК банка получателя
account- (обязательно при выплатах без токена)stringБанковский счет получателя
token- (обязательно при выплатах по токену)stringТокен банковского счета
full_name+stringФИО физического лица. В случае выплаты на счет ИП, передается в следующем формате: ИП <ФИО>. При выплате юридическому лицу — наименование юрлица, если предусмотрено договором. Важно: если наименование или ФИО указано некорректно, банк-получатель может отказать в зачислении и деньги вернутся на счет отправителя
description+stringНазначение выплаты
inn- (обязательно при выплатах на счет юридического лица или ИП)stringИНН получателя, 10 цифр для юридических лиц, 12 цифр - для физических, в том числе для ИП
kpp- (обязательно при выплатах на счет юридического лица)stringKПП получателя, 9 цифр
is_fast-boolПоказывает, нужно ли проводить срочную выплату (через БЭСП). Срочная выплата проходит в течение часа, обычная — за 1—3 банковских дня

BankAccountRUInfo​

Объект с информацией о токене банковского счета.

НазваниеОбязательностьТипОписание
created_at+stringДата создания в формате ISO 8601
finished_at+stringДата завершения в формате ISO 8601
masked_account+stringМаскированный банковский счет

BankCard​

Объект карты в открытом виде (можно использовать, если у вас есть PCI DSS).

НазваниеОбязательностьТипОписание
number+stringНомер карты
expiration_month- (Обязателен для приема платежей при наличии на карте)stringМесяц
expiration_year- (Обязателен для приема платежей при наличии на карте)stringГод
security_code- (Обязателен для приема платежей при наличии на карте)stringСекретный код CVC
cardholder_name-stringИмя владельца карты

CardElements​

Объект с данными банковской карты для токенизации.

НазваниеОбязательностьТипОписание
ref+stringФиксированное значение, всегда number
type+stringФиксированное значение, всегда card_number
card_number+stringНомер карты

CardPaymentMethod​

Объект с данными банковской карты получателя выплаты.

НазваниеОбязательностьТипОписание
type+stringТип передачи данных карты. Возможные варианты: bank_card, encrypted_card, tokenized_card
bank_card-BankCardКарта в открытом виде
encrypted_card-EncryptedCardКарта с шифрованными полями(токенизированная)
tokenized_card-TokenizedCardТокенизированный номер карты
brand-stringИнформация о карте. Возвращается в уведомлениях, нужна для отображения пользователям
last4-stringИнформация о карте. Возвращается в уведомлениях, нужна для отображения пользователям

CardTokenInfo​

Объект с данными о токенизированной банковской карте.

НазваниеОбязательностьТипОписание
number_hash+stringТокен (токенизированный номер карты)
brand+stringПлатежная система, например visa
last4+stringПоследние 4 цифры номера карты

ConfirmInformation​

Объект с информацией для подтверждения операции по номинальному счету.

НазваниеОбязательностьТипОписание
transfer_details+ (для выплат на карты)TransferDetailsИнформация о переводе
account_details+ (для выплат на счета)AccountDetailsИнформация о счетах отправителя и получателя

Contragent​

Объект с информацией о контрагенте.

НазваниеОбязательностьТипОписание
name-stringИмя контрагента
inn-stringИНН контрагента
kpp-stringКПП контрагента
account_number+stringНомер счета контрагента
bank_bik+stringБИК банка контрагента
bank_name-stringНаименование банка контрагента

CounterParty​

Объект с информацией о контрагенте.

НазваниеОбязательностьТипОписание
kpp-stringКПП контрагента
inn-stringИНН контрагента
name+stringНаименование контрагента
account_number+stringНомер счета контрагента
bank_code+stringБИК банка контрагента

Customer​

Данные о пользователе (получателе выплаты или отправителе платежа) в вашей системе. Например, логин, по которому вы сможете идентифицировать пользователя, и его контактная информация.

НазваниеОбязательностьТипОписание
reference+stringИдентификатор пользователя (получателя выплаты или отправителя платежа) в вашей системе (до 128 символов)
contacts-array[CustomerContact]Список контактов пользователя

CustomerContact​

Контакты пользователя (получателя выплаты или отправителя платежа).

НазваниеОбязательностьТипОписание
email-stringЭлектронная почта пользователя
phone-stringТелефон пользователя

CustomerInteraction​

Объект, описывающий взаимодействие с пользователем.

НазваниеОбязательностьТипОписание
type+stringТип взаимодействия с пользователем. Возможные значения: redirect, inform
redirect-CustomerInteractionRedirectОбъект с данными для перенаправления пользователя
inform-CustomerInteractionInformОбъект с информацией о способе платежа

CustomerInteractionInform​

Объект с информацией о способе платежа.

НазваниеОбязательностьТипОписание
qr-QRInformInteractionОбъект с QR-кодом для оплаты по СБП

CustomerInteractionRedirect​

Объект с данными для редиректа (перенаправления пользователя).

НазваниеОбязательностьТипОписание
url+stringАдрес для редиректа вместе с GET-параметрами
base_url+stringАдрес для редиректа
method+stringМетод отправки. Возможные значения: GET, POST
qs-map<string,string>Набор параметров в зависимости от способа прохождения операции
params-map<string,*>Набор параметров в зависимости от способа прохождения операции
  • Проверьте, есть ли какие-либо параметры в объектах qs и params.
  • Перенаправьте пользователя на адрес из base_url при помощи метода, указанного в method, включив все необходимые параметры в URL или в тело запроса.

Data​

Объект с маскированным счетом пользователя.

НазваниеОбязательностьТипОписание
masked_account+stringПервые 5 и последние 4 цифры счета

EncryptedCard​

Карта с шифрованными полями (токенизированная). Передается при проведении выплаты или оплаты через виджет.

НазваниеОбязательностьТипОписание
number_hash+stringХэш номера карты
expiration_date_hash-stringХэш срока действия
security_code_hash-stringХэш секретного кода CVC
cardholder_name_hash-stringХэш имени владельца карты

Error​

Объект с описанием ошибки.

НазваниеОбязательностьТипОписание
code-stringКод ошибки
description-stringОписание ошибки

Коды ошибок

FasterPaymentSystem​

Объект с данными пользователя Системы быстрых платежей.

НазваниеОбязательностьТипОписание
phone+stringТелефон получателя
bank_id+stringИдентификатор банка получателя в СБП
description+stringНазначение выплаты

FasterPaymentSystemVerification​

Объект с данными для проверки регистрации пользователя в Системе быстрых платежей.

НазваниеОбязательностьТипОписание
phone+stringТелефон получателя
bank_id+stringИдентификатор банка получателя в СБП

FiscalizationDetails​

Объект с данными для фискализации.

НазваниеОбязательностьТипОписание
professional_income_taxpayer+ProfessionalIncomeTaxpayerДанные для фискализации самозанятого

FiscalizationReceipt​

Объект с данными чека, созданного при фискализации.

НазваниеОбязательностьТипОписание
id+stringИдентификатор чека
link-stringСсылка на чек

FiscalizationService​

Объект с описанием услуги, за которую отправляется выплата, для фискализации. В одном объекте может содержаться не более 6 услуг.

  • Ограничение на количество услуг устанавливается со стороны ФНС и не контролируется Банком.
  • Что можно сделать, если услуг больше шести:
    • разбить их на несколько чеков,
    • объединить их.
      Пример: если было оказано 10 консультационных услуг по 10 000 рублей за каждую, то можно указать 10 услуг по 10 000 каждая одним пунктом, а не каждую услугу отдельно.
  • Произведение цены услуги и количества услуг должно быть равно сумме выплаты.
НазваниеОбязательностьТипОписание
name+stringНазвание услуги
amount_details+AmountDetailsЦена услуги
quantity-integerКоличество услуг. По умолчанию 1

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

InternalTransferInfo​

Объект с информацией о внутреннем переводе.

НазваниеОбязательностьТипОписание
type+stringТип перевода. Возможные значения: transfer_from_nominal_account, transfer_from_bank_account
transfer_from_nominal_account-TransferFromNominalAccountИнформация о переводе с номинального счета
transfer_from_bank_account-TransferFromBankAccountИнформация о переводе с расчетного счета

InternetBanking​

Объект с информацией об оплате через платежные системы.

НазваниеОбязательностьТипОписание
type+stringПлатежная система. Возможные значения: sber_pay
sber_pay+SberPayИнформация об оплате через SberPay

MerchantFee​

Информация о взимаемой комиссии. Количество объектов соответствует количеству применяемых комиссий.

НазваниеОбязательностьТипОписание
amount+intЗначение суммы в минорных единицах валюты (в копейках). Чтобы передать 100 рублей, укажите 10000
currency+stringКод валюты согласно ISO 4217. Регистр не важен. Варианты: rub, eur

NominalPaymentParticipant​

Данные о плательщике и получателе выплаты c номинального счета.

НазваниеОбязательностьТипОписание
account_number-stringНомер счета
name-stringФИО или наименование
bank_name-stringНаименование банка
bik-stringБИК банка
correspondent_account_number-stringНомер корреспондентского счета
inn-stringИНН банка (только для РКО)
kpp-stringКПП банка (только для РКО)

NotificationCountInformation​

Объект с количеством непрочитанных самозанятыми оповещений из ФНС.

НазваниеОбязательностьТипОписание
tax_reference+stringИНН самозанятого
count-intКоличество непрочитанных оповещений для ИНН из параметра tax_reference

NotificationInformation​

Объект с общей информацией самозанятыми оповещений из ФНС.

НазваниеОбязательностьТипОписание
tax_reference+stringИНН самозанятого
notifications-array[Notifications]Оповещения для ИНН из tax_reference

Notifications​

Массив с подробной информацией об оповещениях, которые ФНС рассылает самозанятым.

НазваниеОбязательностьТипОписание
id+stringИдентификатор оповещения
title+stringЗаголовок оповещения
message+stringТело оповещения
status+stringСтатус оповещения. Возможные варианты: "NEW" — новое "непрочитанное" уведомление; "ACKNOWLEDGED" — прочитанное уведомление; "ARCHIVED" — уведомление, отправленное в архив
created_at+dateTimeДата создания оповещения

Notification_list​

Массив с данными для уведомления ФНС о статусе оповещений для самозанятых.

НазваниеОбязательностьТипОписание
message_id_list-array[string]Массив с ID оповещений
tax_reference+stringИНН самозанятого

Participant​

Данные участника выплаты — отправителя или получателя. Набор необходимых данных зависит от способа получения выплаты.

НазваниеОбязательностьТипОписание
full_name- (обязательно для Participant.recipient при выплатах на любые карты)stringПолное имя
first_name-stringИмя
last_name-stringФамилия
middle_name-stringОтчество
company_name-stringНазвание компании
reference-stringИдентификатор получателя на вашей стороне
tax_reference-stringИдентификатор налогоплательщика
beneficiary_id- (обязательно при платежах и выплатах, у которых есть бенефициар или выгодоприобретатель)stringИНН бенефициара или выгодоприобретателя
country_iso3-stringСтрана (ISO-3166-1 alpha-3)
account- (обязательно для Participant.sender при выплатах с номинального счета)stringНомер банковского номинального счета, с которого будет осуществляться выплата

ParticipantDetails​

Данные об участниках выплаты.

НазваниеОбязательностьТипОписание
sender-ParticipantДанные отправителя
recipient-ParticipantДанные получателя

Payment​

Объект со всеми данными выплаты.

НазваниеОбязательностьТипОписание
id+stringИдентификатор выплаты
status+stringСтатус. Возможные варианты: succeeded, in_progress, pending, failed
created_at+stringДата создания в формате ISO 8601
finished_at-stringДата завершения в формате ISO 8601
customer-CustomerДанные получателя в вашей системе. Например, логин, по которому вы сможете идентифицировать получателя на своей стороне
payment_method+PaymentMethodСпособ получения выплаты
amount_details+AmountDetailsСумма
amounts-AmountsКомиссия за операцию
fiscalization_details-FiscalizationDetailsДанные для фискализации
participant_details-ParticipantDetailsДанные об участниках выплаты, которые нужны для ее проведения. Например, имя и адрес отправителя и получателя
refunds-array[Refund]Список возвратов
transaction_info-TransactionInfoДанные о транзакции
metadata-objectДополнительная информация. Любые данные, которые вам необходимы для проведения операции. Возвращаются в ответах и вебхуках
error-ErrorОписание ошибки
 

Статусы выплаты (status)​

  • in_progress — в обработке.
  • pending — ожидает вашего подтверждения (confirm_request) или отмены (cancel_request).
  • succeeded — выплата прошла успешно.
  • failed — выплата не прошла из-за ошибки.

PaymentDetails​

Объект с описанием способа проведения платежа.

НазваниеОбязательностьТипОписание
type+stringТип способа оплаты. Возможные варианты: card, recurrent, internal_transfer, secured_card, faster_payment_system, wallet
card-CardPaymentMethodДанные банковской карты
recurrent-RecurrentTokenInfoДанные для повтора платежа по токену
internal_transfer-InternalTransferInfoДанные для внутреннего перевода
faster_payment_system-FasterPaymentSystemПлатеж через СБП
wallet-WalletPaymentMethodПлатеж через кошелек

PaymentMethod​

Объект с описанием способа получения выплаты.

НазваниеОбязательностьТипОписание
type+stringТип способа получения выплаты. Возможные варианты: card, bank_account, wallet, tax , recurrent, tokenized_card
card-CardPaymentMethodБанковская карта получателя
bank_account-BankAccountPaymentMethodБанковский счет получателя
wallet-WalletPaymentMethodЭлектронный кошелек получателя
tax-TaxPaymentMethodВыплата в налоговую
recurrent-RecurrentTokenВыплата с использованием токена
tokenized_card-TokenizedCardВыплата с использованием токенизированного номера карты

PaymentOptions​

Параметры для проведения платежа.

НазваниеОбязательностьТипОписание
return_url-stringURL, на который нужно перенаправить пользователя после проведения платежа. URL должен быть валидным
recurrent-boolНужно ли провести платеж с помощью сохраненного токена
expiration_at-datetimeimmutableКастомное время жизни инвойса. Формат: ГГГГ-ММ-ДД ЧЧ:ММ:СС

PaymentSession​

Контейнер с данными о всех операциях, которые проводились в рамках одной платежной сессии.

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

НазваниеОбязательностьТипОписание
id+stringИдентификатор сессии
status+stringСтатус. Возможные значения: created, in_progress, accepted, cancelled, error
created_at+stringДата создания в формате ISO 8601
updated_at+stringДата обновления в формате ISO 8601
payments-array[Payment]Список выплат, которые проводились в рамках этой сессии
acquiring_payments-array[AcquiringPayment]Список платежей, которые проводились в рамках этой сессии
next_action-stringМетка, указывающая на действия для успешного прохождения транзакции. Возможные значения: confirm, capture
error-ErrorОписание ошибки

Статусы платежной сессии (status)​

  • created — сессия создана, ожидает старта или отмены.
  • in_progress — в обработке.
  • accepted — успешно завершена.
  • cancelled — отменена.
  • error — в процессе работы произошла непредвиденная ошибка.

    Внимание! Данный статус не является финальным. Обратитесь в поддержку Банка 131 и дождитесь финального статуса транзакции.

Дальнейшие действия (next_action)​

Если это поле не пустое, значит, Банк 131 ждет от вас определенных действий, чтобы продолжить операцию:

ProfessionalIncomeTaxpayer​

Объект с данными для фискализации самозанятого.

НазваниеОбязательностьТипОписание
services+array[FiscalizationService]Список оказанных услуг (не более 6)
tax_reference+stringИНН самозанятого
receipt-FiscalizationReceiptФискальный чек. Возвращается в уведомлениях
payer_type-stringТип плательщика (тот, кто платит самозанятому). Возможные варианты: legal, individual, foreign
payer_tax_number-stringИНН плательщика. Обязателен для payer_type: legal
payer_name-stringИмя или название плательщика. Обязателен для payer_type: legal

 Тип плательщика payer_type​

Тип плательщика. Возможные варианты:

  • legal — юридическое лицо,
  • individual — физическое лицо,
  • foreign — нерезидент РФ.

PublicToken​

Объект с информацией о публичном токене.

НазваниеОбязательностьТипОписание
token+stringТокен

PublicTokenInfo​

Объект с информацией о публичном токене.

НазваниеОбязательностьТипОписание
token+stringТокен
created_at+stringДата создания в формате ISO 8601
finished_at+stringДата завершения в формате ISO 8601
is_active+boolМожно ли проводить операции по этому токену: true — можно,  false — нельзя

QRInformInteraction​

Объект, в котором содержится QR-код для оплаты по СБП.

НазваниеОбязательностьТипОписание
content+stringСсылка на QR-код
img+stringСодержимое QR-кода

RecurrentToken​

Объект с информацией о токене.

НазваниеОбязательностьТипОписание
token+stringТокен

RecurrentTokenInfo​

Объект с информацией о токене. Подробнее о рекуррентных платежах и настройках токена.

НазваниеОбязательностьТипОписание
token+stringТокен
created_at+stringДата создания в формате ISO 8601
finished_at+stringДата завершения в формате ISO 8601. Не обрабатывается Банком и не влияет на срок действия токена
is_active+boolМожно ли проводить операции по этому токену: true — можно,  false — нельзя
initiator-stringВид рекуррентного платежа. Возможные значения: merchant — платеж MIT (по умолчанию), client — платеж CIT

Refund​

Объект с информацией о возврате.

НазваниеОбязательностьТипОписание
id+stringУникальный идентификатор возврата
status+stringСтатус возврата. Возможные значения: in_progress, accepted, declined, error
amount_details+AmountDetailsОбъект с суммой возврата
created_at+stringДата создания
finished_at-stringДата завершения
is_chargeback-boolПоказывает, совершен ли возврат в рамках чарджбека
transaction_info-TransactionInfoДанные о транзакции

Статусы возврата (status)​

  • in_progress — в обработке.
  • accepted — возврат прошел успешно.
  • declined — Банк 131 отклонил возврат.
  • error — возврат не прошел из-за ошибки.

SberPay​

Информация для оплаты через SberPay.

НазваниеОбязательностьТипОписание
phone-stringНомер телефона для отправки PUSH или СМС. Формат: 7**********
channel+ENUMКанал приема оплаты через SberPay. Возможные значения: app, mobile_web, web

SelfEmployedWidgetMetadata​

Объект с настройками виджета для привязки самозанятого к Банку 131.

НазваниеОбязательностьТипОписание
tax_reference- (если передан phone)stringИНН самозанятого
phone- (если передан tax_reference)stringТелефон самозанятого

TaxDetails​

Объект с данными для платежей в налоговую.

НазваниеОбязательностьТипОписание
period- (Обязательно для выплаты с расширенным набором параметров)stringПериод. Формат ввода описан ниже
kbk- (Обязательно для выплаты с расширенным набором параметров)stringКод бюджетной классификации, 20 цифр
oktmo- (Обязательно для выплаты с расширенным набором параметров)stringОбщероссийский классификатор территорий муниципальных образований, 8 или 11 цифр
payment_reason- (Обязательно для выплаты с расширенным набором параметров)stringОснование платежа. Формат ввода описан ниже
document_number- (Обязательно для выплаты с расширенным набором параметров)stringНомер документа. Формат ввода описан ниже
document_date- (Обязательно для выплаты с расширенным набором параметров)stringДата документа. Формат ввода описан ниже
Формат ввода для поля period при запросе с расширенным набором параметров​
  • Если в поле payment_reason указано «ТП» или «ЗД», то указывается периодичность уплаты налога, установленная законодательно, в одном из нижеприведенных форматов:
    • для ежемесячных уплат: «МС.ХХ.ГГГГ», где ХХ — номер месяца (от 01 до 12), а ГГГГ — год, за который производится платеж (например, при уплате НДФЛ с зарплаты работников за февраль 2020 г. нужно проставить «МС.02.2020»);
    • для налогов, уплачиваемых ежеквартально: «КВ.ХХ.ГГГГ», где ХХ — номер квартала (от 01 до 04), ГГГГ — год, за который уплачивается налог;
    • для полугодовых налогов (к примеру, ЕСХН): «ПЛ.ХХ.ГГГГ», где ХХ — номер полугодия (01 или 02), ГГГГ — год, за который перечисляется налог;
    • для годовых платежей: «ГД.00.ГГГГ», где ГГГГ — год, за который уплачивается налог (например, производя окончательный расчет по налогу на прибыль за 2019 год, нужно будет поставить «ГД.00.2019»).
  • Если в поле payment_reason стоит «ТР», то отражается дата требования.
  • Если в поле payment_reason стоит «АП», то ставится «0».
Формат ввода для поля payment_reason при запросе с расширенным набором параметров​
  • «ТП» — при уплате налога/взноса за текущий период.
  • «ЗД» — при добровольном погашении задолженности по налогам/взносам.
  • «ТР» — при погашении задолженности по выставленному требованию ИФНС или ФСС.
  • «АП» — при погашении задолженности по акту проверки (до выставления требования).
Формат ввода для поля document_number при запросе с расширенным набором параметров​
  • Если в поле payment_reason стоит «ТП» или «ЗД», то «0».
  • Если в поле payment_reason стоит «ТР», то номер налогового требования об уплате.
  • Если в поле payment_reason стоит «АП», то номер решения, вынесенного по результатам проверки.
Формат ввода для поля document_date при запросе с расширенным набором параметров​
  • Если в поле payment_reason стоит «ТП», то дата подписания декларации или «0», если дата не указана.
  • Если в поле payment_reason стоит «ЗД», то «0».
  • Если в поле payment_reason стоит «ТР», то дата требования об уплате.
  • Если в поле payment_reason стоит «АП», то дата послепроверочного решения.

TaxFull​

Объект с данными для уплаты налогов с расширенным набором полей.

НазваниеОбязательностьТипОписание
uin+stringУникальный идентификатор начисления. Для платежей в налоговую всегда 0
description+stringНазначение выплаты
tax_details+stringДанные о платеже в налоговую
payer+TaxRuPayerДанные отправителя для платежа в налоговую
payee+TaxRuPayeeДанные получателя для платежа в налоговую

TaxPaymentMethod​

Объект с данными для уплаты налогов.

НазваниеОбязательностьТипОписание
type+stringТип налога или способ оплаты. Варианты: tax_short, tax_full
tax_full+TaxFullДанные для платежей в налоговую с расширенным набором параметров
tax_details- (необходимо для выплаты с минимальным набором полей)TaxDetailsДанные для платежей в налоговую с минимальным набором полей

TaxPeriod​

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

НазваниеОбязательностьТипОписание
type+stringТип периода. Варианты: month (налог за месяц), quarter (налог за квартал)
number+numberЗависит от типа периода. Для month — номер месяца (от 1 до 12), для quarter — номер квартала (от 1 до 4)
year+stringГод, 4 цифры. Пример: 2021

TaxRuPayee​

Объект с данными получателя для платежей в налоговую с расширенными параметрами.

НазваниеОбязательностьТипОписание
bik+stringБИК банка получателя
account+stringНомер счета
account_eks+stringЕдиный казначейский счет
name+stringНаименование получателя
inn+stringИНН получателя, 10 цифр

TaxRuPayer​

Объект с данными отправителя для платежей в налоговую с расширенными параметрами.

НазваниеОбязательностьТипОписание
kpp+stringKПП отправителя, 9 цифр
inn+stringИНН получателя, 10 цифр

TokenizeData​

Объект с токеном и токенизированным номером карты.

НазваниеОбязательностьТипОписание
number+TokenizeNumberДанные о токене

TokenizedCard​

Объект с токенизированным номером карты.

НазваниеОбязательностьТипОписание
token+stringТокен

TokenizeInfo​

Объект с данными токенизированной карты.

НазваниеОбязательностьТипОписание
masked_card_number+stringМаскированный номер карты
card_network+stringПлатежная система карты
card_type+stringТип карты

TokenizeNumber​

Объект с токеном и данными токенизированной карты.

НазваниеОбязательностьТипОписание
token+stringТокен
info+TokenizeInfoДанные о карте

TokenizeWidgetMetadata​

Объект с настройками для виджета токенизации.

НазваниеОбязательностьТипОписание
access+boolМожет ли этот публичный ключ использовать виджет токенизации

TotalBalance​

Объект с информацией по балансу.

НазваниеОбязательностьТипОписание
opening+intВходящий остаток по счёту на дату начала выписки
closing+intИсходящий остаток по счёту на дату окончания выписки

TotalTurnover​

Объект с информацией по движению средств.

НазваниеОбязательностьТипОписание
debet+intСумма списаний по счёту за период выписки
credit+intСумма пополнений по счёту за период выписки

TransactionInfo​

Объект с информацией о транзакции.

НазваниеОбязательностьТипОписание
rrn+stringУникальный идентификатор транзакции (Retrieval Reference Number)
ern-stringУникальный номер операции с кредитными картами (Acquirer Reference Number)
auth_code-stringКод авторизации

Transactions​

Массив со списком транзакций.

НазваниеОбязательностьТипОписание
amount+intСумма транзакции (только неотрицательные значения)
base_amount-intСумма операции в валюте. Заполняется только для транзакций в валюте, отличной от рублей. При использовании базовой валюты (RUB) параметр является необязательным
currency+stringВалюта операции
payment_date+dateДата операции
bank_system_id+stringИдентификатор платежа. Указывается для любого движения денежных средств по счету:
- для платежей, отправленных по API
- для переводов из другого банка
- для платежей, совершенных через интернет-банк
transaction_id-stringИдентификатор транзакции. Передается для платежей, отправленных по API
session_id-stringИдентификатор сессии. Передается для платежей, отправленных по API
purpose+stringНазначение платежа
counter_party+CounterPartyИнформация о плательщике
type+stringТип транзакции. Может принимать значения credit (для операции пополнения) или debet (для операции списания)

TransferDetails​

Объект с информацией о переводе.

НазваниеОбязательностьТипОписание
payment_method+CardPaymentMethodСпособ получения выплаты
customer+NominalPaymentParticipantИнформация о плательщике
recipient+NominalPaymentParticipantИнформация о получателе
purpose+stringНазначение выплаты в следующем формате: <описание>; card:<маска карты>
amount+AmountDetailsСумма

TransferFromBankAccount​

Объект с информацией о переводе с расчетного счета.

НазваниеОбязательностьТипОписание
description+stringОписание

TransferFromNominalAccount​

Объект с информацией о переводе с номинального счета.

НазваниеОбязательностьТипОписание
description+stringОписание

WalletDetails​

Данные о вашем балансе (счете обеспечения) для отправки выплат.

НазваниеОбязательностьТипОписание
id+stringИдентификатор баланса
amount_details+AmountDetailsТекущий баланс

WalletPaymentMethod​

Объект с данными электронного кошелька.

НазваниеОбязательностьТипОписание
type+stringТип кошелька. Возможные значения: yoomoney
yoomoney-YooMoneyWalletPaymentMethodДанные кошелька ЮMoney (Яндекс.Деньги)

YooMoneyWalletPaymentMethod​

Объект с данными кошелька ЮMoney (Яндекс.Деньги).

НазваниеОбязательностьТипОписание
account+stringНомер кошелька ЮMoney, 11–20 цифр. Пример: 4100175017397
description-stringНазначение платежа, максимум 128 символов. Если будет больше, операция не пройдет