Токенизированная карта
Токенизация карты — это технология обмена конфиденциальных данных банковской карты на специальный обезличенный эквивалент (токен). К ним относятся номер карты и срок ее действия. После выпуска уникального для каждой банковской карты токена оплата покупок происходит с его использованием, что обеспечивает безопасность данных карты при совершении онлайн-платежей. Это возможно благодаря тому, что токен не содержит персональной информации и может быть использован только разово. По нему нельзя восстановить номер платежной карты и, даже если мошенникам удастся перехватить токен, совершить с его помощью платеж они не смогут.
Повсеместное использование данной технологии в мире стало возможно благодаря ее стандартизации ведущими мировыми платежными системами и запуска технологий Visa Token Service (VTS), MasterCard Digital Enablement Service (MDES) и др. В настоящее время токенизация банковских карт применяется:
1. при оплате с мобильного устройства с использованием приложений Apple Pay, Google Pay, Samsung Pay, Mir Pay и др. В этом случае выпуск токена инициирует держатель карты, добавляя ее данные в соответствующее приложение для оплаты. В дальнейшем наличие пластика для проведения оплаты не требуется и управлять токеном (удалять или создавать новый) можно отдельно от банковской карты.
2. при выпуске банками цифровых карт в своих мобильных приложениях. При этом в большинстве случаев предоплаченные виртуальные карты токенизированы быть не могут, но некоторые банки позволяют это делать после прохождения клиентом дальнейшей идентификации;
3. при оплате платежа банковской картой в интернет-магазине или онлайн-сервисе подписки на музыку, фильмы и др. В этом случае выпуск уникального токена на основе данных банковской карты покупателя инициирует торговая точка через платежного эквайера или платежный сервис для удобства хранения полученной информации на серверах платежных систем и обеспечения возможности для последующей оплаты без ввода номера карты держателем. Производить оплату с помощью созданного токена в дальнейшем доступно только в этом магазине или сервисе.
При перевыпуске банковской карты токен не меняется, поэтому заново указывать ее реквизиты держателю карты не требуется.
Как вывести телефон из стоп-листа
Устройство попадает в стоп-лист, когда в транспортной системе по нему есть неоплаченная поездка. Вывести его из стоп-листа можно, погасив задолженность в личном кабинете пассажира.
Чтобы войти в кабинет, нужно знать полный цифровой номер (токен) карты, привязанной к устройству. Он отличается от номера на карте.
Что такое токен и почему он отличается от номера на банковской карте
Когда Вы добавляете банковскую карту в платежное приложение телефона, ей присваивается уникальная комбинация цифр – цифровой номер или токен, который используется при совершении транзакций. В целях безопасности продавцу передаётся только часть номера, и посмотреть его целиком не может даже владелец карты.
Когда Вы регистрируете поездки телефоном, в транспортной системе они учитываются по токену и с номером банковской карты не связаны. Поэтому вводить в личном кабинете номер, указанный на карте, бесполезно.
Как узнать токен
Чтобы узнать токен, Вам потребуется второй телефон с операционной системой Андроид.
Скачайте на телефон с Андроидом бесплатное приложение “Считыватель банковских карт“ из Google Play. Для iOS такого приложения нет. Приложение выводит на экран цифровой номер карты и не предназначено для совершения платежей.
Включите режим оплаты на телефоне, который находится в стоп-листе, и поднесите его к nfc-ридеру телефона с приложением «Считыватель банковских карт».
Когда данные будут прочитаны, на экране приложения появится изображение карты, номер которой будет скрыт звёздочками. Кликните на карту.
4 цифры токена можно узнать в платёжном приложении телефона, в котором подключена находящаяся в стоп-листе карта. Эти цифры отличаются от тех, которые указаны на самой карте.
Mir Pay: в приложении перейдите на вкладку «Карты» и кликнете на карту, которая находится в стоп-листе. Нужные 4 цифры будут указаны в верхней строчке над изображением карточки.
SberPay: в приложении Сбербанк Онлайн откройте раздел «Настройки» и выберите «SberPay». 4 цифры будут указаны в строчке «Виртуальный номер».
Введите 4 цифры токена в приложение «Считыватель банковских карт» и нажмите зелёную кнопку. Звёздочки на изображении карты поменяются на цифры — используйте эти цифры для входа в личный кабинет пассажира.
Когда мы тестировали работу приложения, нам удалось получить токен со второго раза. Поэтому если приложение не смогло прочитать токен, попробуйте ещё раз.
Как войти в ЛК и погасить задолженность
Введите токен и код с картинки и нажмите «Войти».
Шаг 2
На странице истории оплаты проезда Вы увидите кнопку «Погасить задолженность» и сумму долга. Неоплаченная поездка будет иметь статус «Запрещена».
Чтобы оплатить поездки, убедитесь, что денег на карте достаточно, и нажмите «Погасить задолженность».
Банк автоматически произведёт списание средств. Мобильный банк пришлёт сообщение о покупке в DATA.KGILC.RU LKP.
На странице истории оплаты появится строка об успешном ручном погашении, а статус неоплаченной поездки изменится на «Поездка оплачена».
Телефон будет выведен из стоп-листа в течение суток после списания.
Если деньги на Вашей карте есть, но списания не происходит, напишите в сообщения группы — скорее всего, по карте есть техническая ошибка списания на стороне банка.
Токен
Токен — это цифровой актив (сертификат), который представляет определенную стоимость, функционирует на основе блокчейна или другой децентрализованной сети и гарантирует обязательства компании перед его владельцем.
Токены могут быть использованы для предоставления доли в проекте, доступа к определенным услугам или продуктам, наград и так далее.
Токены можно создавать на различных платформах, таких как Ethereum (используя стандарт ERC-20 или ERC-721), Binance Smart Chain (BEP-20) или другие блокчейны. Они часто распространяются через процесс, называемый Initial Coin Offering (ICO) или Initial Token Offering (ITO).
Каждый токен имеет свои уникальные свойства, которые определяют его функциональность, права и ограничения. Некоторые токены могут быть обмениваемыми (фунгибельными), то есть их можно свободно передавать и обменивать, а другие могут быть уникальными (непередаваемыми), представляя уникальные объекты, например, в случае криптоигр или искусства.
Токены обычно содержат следующую информацию:
— Идентификатор токена (Token ID), который однозначно идентифицирует конкретный токен в рамках его блокчейна.
— Владелец токена (Token Owner) — адрес кошелька или публичный ключ владельца токена.
— Баланс токена (Token Balance), то есть количество токенов, доступных для использования или передачи.
— Метаданные токена (Token Metadata) — дополнительная информация о токене, такая как его имя, символ, описание, изображение или ссылки на дополнительные ресурсы.
В зависимости от назначения токена он может содержать дополнительные свойства, такие как дата создания, цена, история трансакций или другие пользовательские данные.
Виды токенов
Платежный. Используется для проведения платежей и финансовых трансакций. NFT (Non-Fungible Token — Невзаимозаменяемый токен), который используют для представления уникальных цифровых активов, таких как цифровое искусство, коллекционные предметы или виртуальные земли.
Стейблкоин (Stablecoin). Токен, привязанный к стоимости или стабильному активу, обычно к фиатной валюте (например, доллар США). Стейблкоины разработаны для минимизации волатильности и обеспечения стабильности цены.
Децентрализованный. Токен, созданный на базе децентрализованной блокчейн-платформы, например, Ethereum. Децентрализованные токены обычно имеют протоколы и смарт-контракты, которые определяют их функциональность и правила использования.
Утилитарный. Токен, предназначенный для использования внутри определенной платформы или экосистемы. Он может давать право на доступ к определенным продуктам, услугам или функциональности.
Токен безопасности (Security Token) представляет долю или права в компании или финансовом активе.
Privacy Coin — криптовалюта, обеспечивающая дополнительную конфиденциальность и анонимность трансакций.
Биржевой токен используют на криптовалютных биржах.
Токен-мем. Шутливый токен, созданный на основе интернет-шутки. Обычно он не имеет реальной стоимости и используется для развлечения.
Особенности участия токена в биржевых процессах
Initial Coin Offerings (ICO) или Initial Token Offerings (ITO) — процессы, в которых стартапы или проекты предлагают токены в обмен на криптовалюту или фиатные деньги. ICO и ITO являются способом финансирования проектов и получения токенов на ранней стадии.
Стейкинг — процесс хранения средств в криптовалютном кошельке, который позволяет поддерживать работу блокчейна, при этом пользователь получает вознаграждение в виде дополнительных токенов.
Добыча (майнинг) — процесс получения токенов в обмен на создание структурных единиц для поддержания функционирования криптовалютных платформ.
Чем отличается токен от криптовалюты
Токены и криптовалюты являются двумя разными концепциями в контексте криптографии и блокчейна.
Криптовалюта обычно служит средством сохранения стоимости.
Токены могут выполнять более широкий спектр функций, например, использоваться для предоставления прав, доступа к услугам, владения уникальными активами, игр и многого другого.
Криптовалюту обычно добывают, при этом блоки трансакций проверяют и подтверждают участники сети. Криптовалюты имеют свои собственные блокчейны или работают на основе существующих блокчейнов, таких как биткоин или эфириум.
Токены чаще всего выпускают на основе существующих блокчейнов, таких как Ethereum, и используют их протоколы и инфраструктуру.
Криптовалюта является взаимозаменяемой, а токены могут быть как взаимозаменяемыми, так и непередаваемыми.
Криптовалюта имеет собственную стоимость. Токены могут иметь как свою собственную стоимость, так и быть привязанными к стоимости других активов, таких как фиатные валюты или сырьевые товары.
Внимание! Данная информация не является индивидуальной инвестиционной рекомендацией, и финансовые инструменты, организации, сервисы (сайты, ресурсы), сделки либо операции, упомянутые в ней, могут не соответствовать вашему инвестиционному профилю и инвестиционным целям (ожиданиям), Банки.ру не осуществлял проверку упомянутых сервисов и организаций. Определение соответствия финансового инструмента, сделки либо операции вашим интересам, инвестиционным целям, инвестиционному горизонту и уровню допустимого риска является вашей задачей.
Банки.ру не несет ответственности за информацию, предоставленную в настоящей статье, за возможные убытки в случае совершения операций, сделок либо инвестирования в финансовые инструменты, упомянутые в данной информации, и не рекомендует использовать указанную информацию в качестве единственного источника информации при принятии инвестиционного решения.
Криптовалюта обладает существенным риском полного обесценения в случае потери доверия к ней пользователей и потери всех вложенных средств.
Получение операций по счету
Обращаем внимание, что с 01.10.2023 необходимо подключаться к новым методам /v2/ :
- /v2/statement/transactions
- /v2/statement/transactionId
- /v2/statement/transactionId/print
- /v2/statement/summary
Для обращения к ресурсу необходимо отправлять запрос на:
- Текущий тестовый контур https://edupirfintech.sberbank.ru:9443
- Новый тестовый контур https://iftfintech.testsbi.sberbank.ru:9443
- Промышленный контур https://fintech.sberbank.ru:9443
Максимальное количество операций, возвращаемых на одной странице выписки, равно 100 (для ПРОМ контура). Запросы выписки подсчитываются исходя из количества опрашиваемых счетов и количества заданных обновлений выписки.
Получение выписки по счету
Ресурс /v1/statement/transactions предназначен для получения данных об операциях по счету, отражаемых в разделе «Выписки и отчеты» в веб-версии CберБизнес.
Шаги
1. Получить AccessToken.
2. Отправить запрос.
Для получения выписки по счету пользователя необходимо отправить GET-запрос (/v1/statement/transactions), в котором передать авторизационный токен к данным собственной организации (Access Token), номер счета (accountNumber), дату выписки (statementDate) и номер запрашиваемой страницы (page=1). Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис GET_STATEMENT_ACCOUNT .
Модель запроса
| Наименование | Описание |
|---|---|
| Параметры заголовка | |
| Authorization (String) | Access token пользователя, полученный через SSO Пример: Bearer 8190f687-c916-453b-9d68-0ce22f4f3f9d-1 |
| Параметры запроса | |
| accountNumber (String) | Номер счета |
| statementDate (DateTime) | Дата запрашиваемой выписки |
| page (Integer) | Номер запрашиваемой страницы. По умолчанию 100 операций на странице. |
| curFormat (String, optional) | Формат операции по валютному счету |
Пример запроса
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 8190f687-c916-453b-9d68-0ce22f4f3f9d-1' 'https://edupirfintech.sberbank.ru:9443/fintech/api/v1/statement/transactions?accountNumber=40702810340399653236&statementDate=2019-06-26&page=1' Выписка может приходить как по рублевым, так и по валютным счетам.
Для рублевого счета не заполняется параметр curFormat, данные передаются в обычном формате.
Параметр curFormat влияет на формат данных для валютных счетов и принимает следующие значения:
- curTransfer,
- swiftTransfer.
Если curFormat = swiftTransfer, то данные по счету будут переданы в формате МТ103. Если curFormat = curTransfer, то данные по валютному счету будут переданы в том же формате, что и данные по рублевому счету. По умолчанию для валютных счетов curFormat = swiftTransfer.
Необходимо запрашивать постранично данные операции, начиная с первой страницы.
На запрос первой страницы в ответе вернется список операций (если существуют операции за выбранную дату и счет) и контейнер links с параметром (href) на следующую страницу и признаком «rel»: «next». На запрос второй страницы в ответе вернется список операций и контейнер links с параметром (href) на следующую и предыдущую страницы и признаками: «rel»: «prev», «rel»: «next». Получение последующих страниц производится по аналогии.
Если следующей страницы нет, в полученном ответе перестанет приходить href c признаком «rel»: «next».
Дата запрашиваемой выписки не может быть ранее 1.01.2017. В получаемой выписке внутри каждой операции сначала отображается информация по плательщику, а затем информация по получателю.
Для получения тестовой выписки в Swagger необходимо использовать:
- Access token 9e1efef1-e584-4c6f-9da3-34a04d203308-1;
- параметры:
- accountNumber=40702810038120042645,
- statementDate=2021-03-24.
Модель ответа
Наименование Описание StatementTransactions _links (Array [Link] , optional) Ссылки на связанные ресурсы, transactions (Array [StatementTransaction] , optional) Данные по операциям выписки >Link href (string) Абсолютный или относительный адрес, rel (string) Отношение ссылки к текущей сущности (next, prev) >StatementTransaction amount (Amount, optional) Сумма в валюте счета, amountRub (Amount, optional) Сумма в рублях, correspondingAccount (string, optional) Корреспондирующий счет, direction (string, optional) Направление транзакции DEBIT/CREDIT= [‘DEBIT’,’CREDIT’]
stringEnum: «DEBIT», «CREDIT»documentDate (string, optional) Дата документа, filial (string, optional) Наименование филиала, number (string, optional) Номер операции, operationCode (string, optional) Тип операции, operationDate (string, optional) Дата и время операции, paymentPurpose (string, optional) Назначение платежа, priority (string, optional) Очередность платежа, revaln (string, optional) Признак операции переоценки (ПК — пересчет курса, ДП — дооценка руб. покрытия), rurTransfer (RURTransfer, optional) Данные рублевой операции, swiftTransfer (SWIFTTransfer, optional) Данные перевода SWIFT MT103 (только для валютных операций), uuid (string, optional) Уникальный идентификатор операции (UUID) transactionId (number, optional) Идентификатор операции >Amount amount (number, optional) Сумма, currencyName (string, optional) Буквенный ISO-код валюты > CurTransfer bankOperationCode (string, optional) Код банковской операции (формат MT103), beneficiaryBankAccount (string, optional) Номер счета банка бенефициара. 1-я часть значения поля 57 в формате MT103, beneficiaryBankName (string, optional) Код BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103, beneficiaryBankOption (string, optional) Признак вида поля банка бенефициара (поле 57 в формате MT103).
Возможные значения: A, B, С, D,beneficiaryCustomerAccount (string, optional) Номер счета бенефициара. 1-я часть значения поля 59 в формате MT103, beneficiaryCustomerName (string, optional) Код BIC/BEI или название и адрес бенефициара. Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103, detailsOfCharges (string, optional) Сведения о расходах (формат MT103), exchangeRate (string, optional) Курс конвертации (формат MT103), instructedAmount (string, optional) Валюта/сумма по инструкции (формат MT103), instructionCode (string, optional) Код инструкции (формат MT103), intermediaryBankAccount (string, optional) Номер счета банка-посредника. 1-я часть значения поля 56 в формате MT103, intermediaryBankName (string, optional) Код BIC или название банка-посредника.Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103, intermediaryBankOption (string, optional) Признак вида поля банка-посредника (поле 56 в формате MT103).
Возможные значения: A, С, D,messageDestinator (string, optional) Получатель сообщения SWIFT (формат MT103), messageIdentifier (string, optional) Уникальный системный номер сообщения SWIFT (формат MT103), messageOriginator (string, optional) Отправитель сообщения SWIFT (формат MT103), messageReceiveTime (string, optional) Дата и время получения сообщения SWIFT (формат MT103), messageSendTime (string, optional) Дата и время отправки сообщения SWIFT (формат MT103), messageType (string, optional) Тип сообщения SWIFT, orderingCustomerAccount (string, optional) Номер счета плательщика в формате IBAN или BBAN (для внутренних платежей). 1-я часть значения поля 50 в формате MT103, orderingCustomerName (string, optional) Код BIC/BEI или название и адрес плательщика. Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103, orderingCustomerOption (string, optional) Признак вида поля плательщика (поле 50 в формате MT103).
Возможные значения: A, F, K,orderingInstitutionAccount (string, optional) Номер счета банка плательщика. 1-я часть значения поля 52 в формате MT103, orderingInstitutionName (string, optional) Код BIC или название и адрес банка плательщика. Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103, orderingInstitutionOption (string, optional) Признак вида поля банка плательщика (поле 52 в формате MT-103).
Возможные значения: A, D,payeeBankBic (string, optional) БИК банка получателя, payeeBankCorrAccount (string, optional) Корсчет банка получателя, payeeAccount (string, optional) Номер счета получателя, payeeBankName (string, optional) Наименование банка получателя, payeeInn (string, optional) ИНН получателя, payeeKpp (string, optional) КПП получателя, payeeName (string, optional) Наименование получателя, payerBankBic (string, optional) БИК банка плательщика, payerBankCorrAccount (string, optional) Корсчет банка плательщика, payerAccount (string, optional) Номер счета плательщика, payerBankName (string, optional) Наименование банка плательщика, payerInn (string, optional) ИНН плательщика, payerKpp (string, optional) КПП плательщика, payerName (string, optional) Наименование плательщика, receiverCharges (string, optional) Расходы получателя (формат MT103), receiverCorrespondentAccount (string, optional) Номер счета корреспондента получателя.1-я часть значения поля 54 в формате MT103, receiverCorrespondentName (string, optional) Код BIC, расположение или название и адрес корреспондента получателя. Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103, receiverCorrespondentOption (string, optional) Признак вида поля корреспондента получателя (поле 54 в формате MT103).
Возможные значения: A, B, D,regulatoryReporting (string, optional) Контрольная отчетность (формат MT103), remittanceInformation (string, optional) Сведения о переводе (формат MT103), senderCharges (string, optional) Расходы отправителя (формат MT103), senderCorrespondentAccount (string, optional) Номер счета корреспондента отправителя.1-я часть значения поля 53 в формате MT103, senderCorrespondentName (string, optional) Код BIC, расположение или название и адрес корреспондента отправителя. Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103, senderCorrespondentOption (string, optional) Признак вида поля корреспондента отправителя (поле 53 в формате MT103).
Возможные значения: A, B, D,senderToReceiverInformation (string, optional) Информация отправителя получателю (формат MT103), transactionReferenceNumber (string, optional) Референс операции (формат MT103), transactionRelatedReference (string, optional) Связанный референс (формат MT103), transactionTypeCode (string, optional) Код типа операции (формат MT103), urgent (string, optional) Признак срочности операции (формат MT103). Возможные значения: URGENT, NORMAL, valueDateCurrencyInterbankSettledAmount (string, optional) Дата валютирования, код валюты, сумма межбанковского расчета (формат MT103) >, RURTransfer cartInfo (CartInfo, optional) Дополнительная информация о документе (картотека), deliveryKind (string, optional) Способ отправки документа, departmentalInfo (DepartmentalInfo, optional) Реквизиты налогового, таможенного или иного бюджетного платежа, payeeAccount (string, optional) Номер счета получателя, payeeBankBic (string, optional) БИК банка получателя, payeeBankCorrAccount (string, optional) Корсчет банка получателя, payeeBankName (string, optional) Наименование банка получателя, payeeInn (string, optional) ИНН получателя, payeeKpp (string, optional) КПП получателя, payeeName (string, optional) Наименование получателя, payerAccount (string, optional) Номер счета плательщика, payerBankBic (string, optional) БИК банка плательщика, payerBankCorrAccount (string, optional) Корсчет банка плательщика, payerBankName (string, optional) Наименование банка плательщика, payerInn (string, optional) ИНН плательщика, payerKpp (string, optional) КПП плательщика, payerName (string, optional) Наименование плательщика, payingCondition (string, optional) Условие оплаты (для 02), purposeCode (string, optional) Кодовое назначение платежа
Коды:
1 — При переводе денежных средств, являющихся заработной платой и (или) иными доходами, в отношении которых статьей 99 Федерального закона N 229-ФЗ установлены ограничения.
2 — При переводе денежных средств, являющихся доходами, на которые в соответствии со статьей 101 Федерального закона N 229-ФЗ не может быть обращено взыскание, за исключением доходов, указанных в пунктах 1 и 4 части 1 статьи 101 Федерального закона N 229-ФЗ.
3 — При переводе денежных средств, являющихся видами доходов, на которые в соответствии с пунктами 1 и 4 части 1 статьи 101 Федерального закона N 229- ФЗ не может быть обращено взыскание,receiptDate (string, optional) Дата поступления в банк плательщика, valueDate (string, optional) Дата валютирования, >SWIFTTransfer bankOperationCode (string, optional) Код банковской операции (формат MT103), beneficiaryBankAccount (string, optional) Номер счета банка бенефициара. 1-я часть значения поля 57 в формате MT103, beneficiaryBankName (string, optional) Код BIC, расположение или название и адрес банка бенефициара. Содержимое поля 57 (за исключением номера счета, с разделителями) в формате MT103, beneficiaryBankOption (string, optional) Признак вида поля банка бенефициара (поле 57 в формате MT103).
Возможные значения: A, B, С, D,beneficiaryCustomerAccount (string, optional) Номер счета бенефициара. 1-я часть значения поля 59 в формате MT103, beneficiaryCustomerName (string, optional) Код BIC/BEI или название и адрес бенефициара. Содержимое поля 59 (за исключением номера счета, с разделителями) в формате MT103, detailsOfCharges (string, optional) Сведения о расходах (формат MT103), exchangeRate (string, optional) Курс конвертации (формат MT103), instructedAmount (string, optional) Валюта/сумма по инструкции (формат MT103), instructionCode (string, optional) Код инструкции (формат MT103), intermediaryBankAccount (string, optional) Номер счета банка-посредника.1-я часть значения поля 56 в формате MT103, intermediaryBankName (string, optional) Код BIC или название банка-посредника.Содержимое поля 56 (за исключением номера счета, с разделителями) в формате MT103, intermediaryBankOption (string, optional) Признак вида поля банка-посредника, (поле 56 в формате MT103).
Возможные значения: A, С, D,messageDestinator (string, optional) Получатель сообщения SWIFT (формат MT103), messageIdentifier (string, optional) Уникальный системный номер сообщения SWIFT (формат MT103), messageOriginator (string, optional) Отправитель сообщения SWIFT (формат MT103), messageReceiveTime (string, optional) Дата и время получения сообщения SWIFT (формат MT103), messageSendTime (string, optional) Дата и время отправки сообщения SWIFT (формат MT103), messageType (string, optional) Тип сообщения SWIFT, orderingCustomerAccount (string, optional) Номер счета плательщика в формате IBAN или BBAN (для внутренних платежей). 1-я часть значения поля 50 в формате MT103, orderingCustomerName (string, optional) Код BIC/BEI или название и адрес плательщика.Содержимое поля 50 (за исключением номера счета, с разделителями) в формате MT103, orderingCustomerOption (string, optional) Признак вида поля плательщика (поле 50 в формате MT103).
Возможные значения: A, F, K,orderingInstitutionAccount (string, optional) Номер счета банка плательщика.1-я часть значения поля 52 в формате MT103, orderingInstitutionName (string, optional) Код BIC или название и адрес банка плательщика.Содержимое поля 52 (за исключением номера счета, с разделителями) в формате MT103, orderingInstitutionOption (string, optional) Признак вида поля банка плательщика (поле 52 в формате MT-103).
Возможные значения A, D,receiverCharges (string, optional) Расходы получателя (формат MT103), receiverCorrespondentAccount (string, optional) Номер счета корреспондента получателя.1-я часть значения поля 54 в формате MT103, receiverCorrespondentName (string, optional) Код BIC, расположение или название и адрес корреспондента получателя. Содержимое поля 54 (за исключением номера счета, с разделителями) в формате MT103, receiverCorrespondentOption (string, optional) Признак вида поля корреспондента получателя (поле 54 в формате MT103).
Возможные значения: A, B, D,regulatoryReporting (string, optional) Контрольная отчетность (формат MT103), remittanceInformation (string, optional) Сведения о переводе (формат MT103), senderCharges (string, optional) Расходы отправителя (формат MT103), senderCorrespondentAccount (string, optional) Номер счета корреспондента отправителя.1-я часть значения поля 53 в формате MT103, senderCorrespondentName (string, optional) Код BIC, расположение или название и адрес корреспондента отправителя. Содержимое поля 53 (за исключением номера счета, с разделителями) в формате MT103, senderCorrespondentOption (string, optional) Признак вида поля корреспондента отправителя (поле 53 в формате MT103).
Возможные значения: A, B, D.senderToReceiverInformation (string, optional) Информация отправителя получателю (формат MT103), transactionReferenceNumber (string, optional) Референс операции (формат MT103), transactionRelatedReference (string, optional) Связанный референс (формат MT103), transactionTypeCode (string, optional) Код типа операции (формат MT103), urgent (string, optional) Признак срочности операции (формат MT103).
Возможные значения: URGENT, NORMAL,valueDateCurrencyInterbankSettledAmount (string, optional) Дата валютирования, код валюты, сумма межбанковского расчета (формат MT103) >CartInfo documentCode (string, optional) Шифр документа (картотека) (для 16), documentContent (string, optional) Содержание операции (для 16), documentDate (string, optional) Дата документа (картотека) (для 16), documentNumber (string, optional) Номер документа (картотека) (для 16), paymentNumber (string, optional) Номер платежа (картотека) (для 16), restAmount (number, optional) Сумма остатка платежа (картотека) (для 16) >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), формат ^(0\|[0-9]\\.[0-9]\\.[0-9])$ , paymentKind110 (string, optional) Тип налогового платежа (реквизит — 110) > Пример ответа
"_links":[ "href":"?accountNumber=40702810500006103990&statementDate=2018-03-15&page=3", "rel":"next" > ], "transactions":[ "amount": "amount":1.01, "currencyName":"USD" >, "amountRub": "amount":1.01, "currencyName":"USD" >, "correspondingAccount":"30101810400000000225", "curTransfer": "bankOperationCode":"CRED", "beneficiaryBankAccount":"LOYDGB21321", "beneficiaryBankName":"BANCO DE SABADELL, S.A.1, PLAZA CATALUNYA SABADELL ES", "beneficiaryBankOption":"D", "beneficiaryCustomerAccount":"/FI8850000120266333", "beneficiaryCustomerName":"SUN-KING KNITTED BELT PRODUCT LTD. N.39,DONGMEN ROAD FUQING CITY,FUJIAN,CHINA", "detailsOfCharges":"OUR", "exchangeRate":"67,74", "instructedAmount":"USD70,", "instructionCode":"URGP", "intermediaryBankAccount":"COBADEFF", "intermediaryBankName":"BANCA POPOLARE DELL'ETRURIA E DEL LAZIO (SEDE DI MILANO)MILANO", "intermediaryBankOption":"D", "messageDestinator":"LAPBLV2X", "messageIdentifier":"S000013082900014", "messageOriginator":"SABRRU2P", "messageReceiveTime":"15-05-27 14:01", "messageSendTime":"15-05-27 13:21", "messageType":"103", "orderingCustomerAccount":"/08251801040004813", "orderingCustomerName":"DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD.NO.98 FANRONG STREET DONGNING COUNTY", "orderingCustomerOption":"K", "orderingInstitutionAccount":"ABOCBNBJ080", "orderingInstitutionName":"AGRICULTURAL BANK OF CHINA, THE(HEILONGJIANG BRANCH) HARBIN", "orderingInstitutionOption":"A", "payeeAccount":"40802810600000200000", "payeeBankBic":"044525225", "payeeBankCorrAccount":"30101810400000000225", "payeeBankName":"ПАО СБЕРБАНК", "payeeInn":"7707083893", "payeeKpp":"222201001", "payeeName":"Общество с ограниченной ответственностью \"Клиент\"", "payerAccount":"40802810600000200000", "payerBankBic":"044525225", "payerBankCorrAccount":"30101810400000000225", "payerInn":"7707083893", "payerKpp":"222201001", "payerBankName":"ПАО СБЕРБАНК", "payerName":"Общество с ограниченной ответственностью \"Клиент\"", "receiverCharges":"EUR13,19", "receiverCorrespondentAccount":"CHASDEFX", "receiverCorrespondentName":"THE BANK OF NEW YORK MELLON NEW YORK,NY", "receiverCorrespondentOption":"D", "regulatoryReporting":"/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7/МS.05.2003/N8/123456789012345/N9/12.05.2003", "remittanceInformation":"CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783", "senderCharges":"USD7,03", "senderCorrespondentAccount":"BOTKGB2L", "senderCorrespondentName":"CITIBANK N.A.NEW YORK,NY", "senderCorrespondentOption":"D", "senderToReceiverInformation":"/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA", "transactionReferenceNumber":"S380609091426498", "transactionRelatedReference":"S380609091426498", "transactionTypeCode":"N1", "urgent":"NORMAL", "valueDateCurrencyInterbankSettledAmount":"130824EUR5447,34" >, "direction":"CREDIT", "documentDate":"2018-12-31", "filial":"ОСБ 3", "number":"4", "operationCode":"01", "operationDate":"2018-12-31T23:59:59", "paymentPurpose":"Оплата заказа №123. НДС нет.", "priority":"5", "revaln":"ПК", "rurTransfer": "cartInfo": "documentCode":"string", "documentContent":"string", "documentDate":"2019-10-19T06:33:47.923Z", "documentNumber":"string", "paymentNumber":"string", "restAmount":0 >, "deliveryKind":"электронно", "departmentalInfo": "uip":"0", "drawerStatus101":"01", "kbk":"18210102010011000110", "oktmo":"01701000", "reasonCode106":"ТП", "taxPeriod107":"ГД.00.2018", "docNumber108":"123", "docDate109":"31.12.2018", "paymentKind110":"1" >, "payeeAccount":"40802810600000200000", "payeeBankBic":"044525225", "payeeBankCorrAccount":"30101810400000000225", "payeeBankName":"ПАО СБЕРБАНК", "payeeInn":"7707083893", "payeeKpp":"222201001", "payeeName":"Общество с ограниченной ответственностью \"Клиент\"", "payerAccount":"40802810600000200000", "payerBankBic":"044525225", "payerBankCorrAccount":"30101810400000000225", "payerBankName":"ПАО СБЕРБАНК", "payerInn":"7707083893", "payerKpp":"222201001", "payerName":"Общество с ограниченной ответственностью \"Клиент\"", "payingCondition":"string", "purposeCode":"2", "receiptDate":"2018-12-31", "valueDate":"2018-12-31" >, "swiftTransfer": "bankOperationCode":"CRED", "beneficiaryBankAccount":"LOYDGB21321", "beneficiaryBankName":"BANCO DE SABADELL, S.A. 1, PLAZA CATALUNYA SABADELL ES ", "beneficiaryBankOption":"D", "beneficiaryCustomerAccount":"/FI8850000120266333", "beneficiaryCustomerName":"SUN-KING KNITTED BELT PRODUCT LTD. N.39,DONGMEN ROAD FUQING CITY,FUJIAN,CHINA", "detailsOfCharges":"OUR", "exchangeRate":"67,74", "instructedAmount":"USD70,", "instructionCode":"URGP", "intermediaryBankAccount":"COBADEFF", "intermediaryBankName":"BANCA POPOLARE DELL'ETRURIA E DEL LAZIO (SEDE DI MILANO) MILANO ", "intermediaryBankOption":"D", "messageDestinator":"LAPBLV2X", "messageIdentifier":"S000013082900014", "messageOriginator":"SABRRU2P", "messageReceiveTime":"15-05-27 14:01", "messageSendTime":"15-05-27 13:21", "messageType":"103", "orderingCustomerAccount":"/08251801040004813", "orderingCustomerName":"DONGNING JIXIN INDUSTRY AND TRADE(GROUP) CO.,LTD. NO.98 FANRONG STREET DONGNING COUNTY", "orderingCustomerOption":"K", "orderingInstitutionAccount":"ABOCBNBJ080", "orderingInstitutionName":"SABRRUMM011 SBERBANK (OPERATIONS DEPARTMENT) MOSCOW", "orderingInstitutionOption":"A", "receiverCharges":"EUR13,19", "receiverCorrespondentAccount":"CHASDEFX", "receiverCorrespondentName":"THE BANK OF NEW YORK MELLON NEW YORK,NY ", "receiverCorrespondentOption":"D", "regulatoryReporting":"/N10/NS/N4/12345678901234567890/N5/12345678901/N6/TP/N7 МS.05.2003/N8/123456789012345/N9/12.05.2003", "remittanceInformation":"CONTRACT NO SE/00233 DATED 06.03.2012, INVOICE NO 4783", "senderCharges":"USD7,03", "senderCorrespondentAccount":"BOTKGB2L", "senderCorrespondentName":"CITIBANK N.A. NEW YORK,NY ", "senderCorrespondentOption":"D", "senderToReceiverInformation":"/NZP/OT 15.03.2009. NDS NE OBLAGAETSYA", "transactionReferenceNumber":"S380609091426498", "transactionRelatedReference":"S380609091426498", "transactionTypeCode":"N1", "urgent":"NORMAL", "valueDateCurrencyInterbankSettledAmount":"130824EUR5447,34" >, "uuid":"55daccdf-de87-3879-976c-8b8415c8caf9", "transactionId":"6540997758406" > ] >Если в запросе был передан http-заголовок Accept со значением application/jose, то ответ вернется в формате JOSE в представлении JWS Compact Serialization.
Получение реквизитов из выписки
Ресурс /v1/statement/transactions/ позволяет получить реквизиты операции из выписки, предварительно получив уведомление с идентификатором операции.
Шаги
1. Получить AccessToken.
2. Отправить запрос.
Для получения реквизитов операции необходимо отправить GET-запрос (/v1/statement/transactions/ ), в котором передать авторизационный токен к данным собственной организации (Access Token) и идентификатор операций. Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис GET_STATEMENT_ACCOUNT .
Модель запроса
Наименование Описание Параметры заголовка Authorization (String) Access token собственной организации, полученный через SSO
Пример: Bearer 8190f687-c916-453b-9d68-0ce22f4f3f9d-1Параметры пути id (String) Идентификатор операции Пример запроса
curl -X GET --header 'Accept: text/html' --header 'Authorization:Bearer 8190f687-c916-453b-9d68-0ce22f4f3f9d-1' 'https://edupirfintech.sberbank.ru:9443/fintech/api/v1/statement/transactions/6540997758406'Модель ответа
Модель ответа совпадает с /v1/statement/transactions .
Получение информации об оборотах
Ресурс /v1/statement/summary позволяет получить информацию о входящих/исходящих остатках и суммарных оборотах за один день. Дата запрашиваемой информации об остатках не может быть ранее 1.01.2017.
Шаги
1. Получить AccessToken.
2. Отправить запрос.
Для получения информации о входящих/исходящих остатках и суммарных оборотах необходимо отправить GET-запрос (/v1/statement/summary), в котором передать авторизационный токен к данным собственной организации (Access Token), номер счета (accountNumber) и дату выписки (statementDate). Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис GET_STATEMENT_ACCOUNT .
Модель запроса
Наименование Описание Параметры заголовка Authorization (String) Access token пользователя, полученный через SSO
Пример: Bearer 8190f687-c916-453b-9d68-0ce22f4f3f9d-1Параметры запроса accountNumber (String) Номер счета statementDate (DateTime) Номер запрашиваемой страницы page (Integer) Номер запрашиваемой страницы. По умолчанию 100 операций на странице. Пример запроса
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 8190f687-c916-453b-9d68-0ce22f4f3f9d-1' 'https://edupirfintech.sberbank.ru:9443/fintech/api/v1/statement/summary? accountNumber=40702810340399653236&statementDate=2019-06-26'Модель ответа
Наименование Описание StatementSummary closingBalance (Amount, optional) Исходящий остаток в валюте счета , closingBalanceRub (Amount, optional) Исходящий остаток в рублях , composedDateTime (string, optional) Дата составления сводки , creditTransactionsNumber (integer, optional) Количество кредитовых операций по счету , creditTurnover (Amount, optional) Кредитовый оборот в валюте счета , creditTurnoverRub (Amount, optional) Кредитовый оборот в рублях , debitTransactionsNumber (integer, optional) Количество дебетовых операций по счету, debitTurnover (Amount, optional) Дебетовый оборот в валюте счета , debitTurnoverRub (Amount, optional) Дебетовый оборот в рублях , lastMovementDate (string, optional) Дата последней операции по счету за запрошенный период, openingBalance (Amount, optional) Входящий остаток в валюте счета,DEBIT, «CREDIT», openingBalanceRub (Amount, optional) Входящий остаток в рублях, openingRate (number, optional) Курс ЦБ за единицу валюты на начало периода >Amount amount (number, optional) Сумма , currencyName (string, optional) Буквенный ISO-код валюты > Пример ответа
"composedDateTime":"2021-03-24T00:00:00", "lastMovementDate":"2017-08-17", "openingRate":null, "openingBalance": "amount":"100.10", "currencyName":"RUB" >, "openingBalanceRub": "amount":"100.10", "currencyName":"RUB" >, "closingBalance": "amount":"100.10", "currencyName":"RUB" >, "closingBalanceRub": "amount":"100.10", "currencyName":"RUB" >, "debitTurnover": "amount":"616147.76", "currencyName":"RUB" >, "debitTurnoverRub": "amount":"616147.76", "currencyName":"RUB" >, "debitTransactionsNumber":15, "creditTurnover": "amount":"616147.76", "currencyName":"RUB" >, "creditTurnoverRub": "amount":"616147.76", "currencyName":"RUB" >, "creditTransactionsNumber":15 >Формирование печатной формы выписки
Ресурс /v1/statement/files позволяет сформировать печатную форму файла выписки и получить идентификатор задачи, по которому можно запросить ссылку на скачивание печатной формы выписки за нужную дату и в разных форматах.
В дальнейшем файл можно загрузить в другие системы.
Шаги
1. Получить AccessToken.
2. Отправить запрос.
3. Получить ссылку на скачивание файла.
Для получения идентификатора задачи, необходимо отправить GET-запрос (/v1/statement/files), в котором передать авторизационный токен к данным собственной организации (Access Token) и параметры запроса. Авторизационный токен передается в параметре Authorization заголовка запроса.
Чтобы получить доступ к ресурсу, необходимо передать в scope сервис GET_STATEMENT_ACCOUNT .
Модель запроса
Наименование Описание Параметры заголовка Authorization (String) Access token организации-клиента, полученный через SSO
Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1Параметры запроса accountNumber (String) Номер счета (^ [0-9] $) Пример: 40702810340399653236 statementDate (Date, optional) Дата запрашиваемой выписки (по умолчанию текущий день) (yyyy-MM-dd) encoding (String, optional) Кодировка выписки (по умолчанию WINDOWS) Варианты кодировок: DOS, WINDOWS, UTF8 format (String) Формат запрашиваемой выписки Варианты форматов: 1С, MT940, camt053 Пример запроса
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1' 'https://edupirfintech.sberbank.ru:9443/fintech/api/v1/statement/files accountNumber=40702810340399653236&statementDate=2019-06 26&encoding=WINDOWS&format=1C'Модель ответа
Наименование Описание taskId (Number) Идентификатор задачи для получения ссылки на скачивание. Возвращается один идентификатор задачи на все выбранные форматы