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

Объекты

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

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Информация о переводе

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Номер корреспондентского счета

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Дата создания оповещения

Notifications_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
payment_method+PaymentMethodСпособ получения выплаты
amount_details+AmountDetailsСумма
amounts-AmountsКомиссия за операцию
finished_at-stringДата завершения в формате ISO 8601
customer-CustomerДанные получателя в вашей системе. Например, логин, по которому вы сможете идентифицировать получателя на своей стороне
fiscalization_details-FiscalizationDetailsДанные для фискализации
participant_details-ParticipantDetailsДанные об участниках выплаты, которые нужны для ее проведения. Например, имя и адрес отправителя и получателя
refunds-array<Refund>Список возвратов
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
card-CardPaymentMethodБанковская карта получателя
bank_account-BankAccountPaymentMethodБанковский счет получателя
wallet-WalletPaymentMethodЭлектронный кошелек получателя
tax-TaxPaymentMethodВыплата в налоговую
recurrent-RecurrentTokenВыплата с использованием рекуррентного токена
tokenize_card-TokenizeCardВыплата с использованием токенизированного номера карты

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 — cессия создана, ожидает старта или отмены;
  • 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Показывает, совершен ли возврат в рамках чарджбека

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

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

SberPay

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

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

SelfEmployedWidgetMetadata

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

НазваниеОбязательностьТипОписание
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+TaxPayerДанные отправителя для платежа в налоговую
payee+TaxPayeeДанные получателя для платежа в налоговую

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 цифр.

TokenizedCard

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

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

TokenizeWidgetMetadata

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

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

TotalBalance

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

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

TotalTurnover

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

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

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, 1120 цифр. Пример: 4100175017397
description-stringНазначение платежа, максимум 128 символов. Если будет больше, операция не пройдет
Обратная связь