ym88659208ym87991671
Pay-Doc-Cur Overview | Документация для разработчиков
Version: 1.0.0

Pay-Doc-Cur Overview

Обновлено 13 марта 2025

Методы для работы с валютным платежным поручением (ВПП)

API URLs

  • Тестовый контур: https://iftfintech.testsbi.sberbank.ru:9443
  • Промышленный контур: https://fintech.sberbank.ru:9443

Дайджесты запросов

Дайджест это текстовый документ, содержащий перечень и значения полей запроса, к которому он относится и предназначенный для подписания ЭЦП. Сохраняйте порядок и количество полей дайджеста, как показано в примере ниже, иначе подписать его не получится.

Формат дайджеста запроса на создание валютного платежного поручения (значения number и блок linkedDocs не используются):

Наименование поляОписание поляПример
addInfoПримечаниеПримечание
additionalInfoИнформация получателю платежа (поле 72)/CCTFDR/
amountTransfer.amountСумма валютного перевода1.00
amountTransfer.currencyCodeЦифровой код валюты840
amountTransfer.currencyNameISO-код валютыUSD
authPersonNameФИО ответственного лицаИванов Алексей Сергеевич
authPersonTelfaxТелефон ответственного лица+74951234567
b77infoИнформация для регулирующих органовИнформация для регулирующих органов
beneficiaryAccountСчет бенефициара40802840600000200000
beneficiaryAddressАдрес бенефициараUL.KUTUZOVSKAYA,D.2
beneficiaryBankAccountКорреспондентский счет банка бенефициара40802840600000200000
beneficiaryBankAddressАдрес банка бенефициараул. Вавилова, д. 19
beneficiaryBankBranchNameНаименование филиала банка бенефициара(TREASURY DEPARTMENT)
beneficiaryBankClearingCode.clearingCodeКлиринговый код банка бенефициара111111
beneficiaryBankClearingCode.countryCodeОбозначение национального клирингового кода банка бенефициараUA
beneficiaryBankClearingCode.shortNameСокращенное наименование национального клирингового кодаСокращенное наименование национального клирингового кода
beneficiaryBankClearingCode.symbolКлиринговый код банка бенефициараUA
beneficiaryBankCountryDigitalЦифровой код страны банка бенефициара643
beneficiaryBankCountryIso22х буквенный ISO-код страны банка бенефициараRU
beneficiaryBankNameНаименование банка бенефициараПАО СБЕРБАНК
beneficiaryBankPlaceМестонахождение банка бенефициараMOSKVA
beneficiaryBankSwiftSWIFT-код банка бенефициараABNARUMMSPB
beneficiaryBeiCodeBEI-код (SWIFT-код)AAAAAAAA
beneficiaryCountryDigitalЦифровой код страны бенефициара643
beneficiaryCountryIso22х буквенный ISO-код страны бенефициараRU
beneficiaryCountryNameНаименование страны бенефициара на русском языке (краткое наименование)Россия
beneficiaryInnИНН бенефициара222201236445
beneficiaryNameНаименование бенефициараEMIRP
beneficiaryPlaceГород (месторасположение) бенефициараMOSKVA
chargesTypeТип комиссии за перевод: BEN, SHA или OURBEN
dateДата документа2019-10-16
externalIdИдентификатор документа в организации-партнере (UUID)619e25cf-dc0b-4420-8957-1b94bf29f145
iMediaBankAddressАдрес банка-посредникаSWEDEN HOUSE
iMediaBankCountryDigitalЦифровой код страны банка-посредника643
iMediaBankCountryIso22х буквенный ISO-код страны банка-посредникаRU
iMediaBankNameНаименование банка-посредникаABN AMRO BANK A.O.
iMediaBankPlaceГород банка-посредникаST. PETERSBURG
iMediaBankSwiftSWIFT-код банка-посредникаABNARUMMSPB
iMediaClearingCode.clearingCodeКлиринговый код банка посредника111111
iMediaClearingCode.countryCodeОбозначение национального клирингового кода банка-посредникаUA
iMediaClearingCode.shortNameСокращенное наименование национального клирингового кода
iMediaClearingCode.symbolОбозначение национального клирингового кода банка-посредникаUA
iMediaFilialBankNameНаименование филиала банка-посредникаОСБ1
innИНН клиента1182079004
option50aОпция "K" для поля 50аK
option56aОпция "A", "D" для поля 56аA
option57aОпция "A", "D" для поля 57аA
option59aОпция "А" для поля 59а или «без опции»A
orgNameНаименование организации клиентаОрганизация YUaegpVCyvHROOE
payerAccountСчет плательщика40702840775470463045
payerAddressАдрес плательщикаUL.DOBROLIUBOVA,D.18,OF.III
payerBankBicБИК банка плательщика044525225
payerBankPlaceМестонахождение банка плательщикаMOSKVA
payerCountryDigitalЦифровой код страны перевододателя643
payerCountryIso22х буквенный ISO-код страны перевододателяRU
payerCountryNameНаименование страны перевододателя на русском языке (краткое наименование)Россия
payerNameМеждународное наименование плательщикаLLC COMPANY
payerPlaceГород (местонахождение) плательщикаMOSKVA
paymentDetailsНазначение платежаABCD
paymentDirectionНаправление платежа (Платеж внутри или вне СБРФ): 1-внутри, 0-вне1
rateAgreeС курсом проведения конверсионной операции согласныtrue
urgentСрочностьfalse
TABLES
Table23E: Код инструкцииCodes23e
codeКод инструкцииTELE
descriptionОписаниеОписание
infoДополнительная информацияИНФО
#Разделитель

Пример дайджеста

addInfo=Примечание
additionalInfo=Информация получателю платежа
amountTransfer.amount=1.00
amountTransfer.currencyCode=840
amountTransfer.currencyName=USD
authPersonName=Иванов Алексей Сергеевич
authPersonTelfax=+74951234567
b77info=Информация для регулирующих органов
beneficiaryAccount=40802840600000200000
beneficiaryAddress=UL.KUTUZOVSKAYA,D.2
beneficiaryBankAccount=40802840600000200000
beneficiaryBankAddress=ул. Вавилова, д. 19
beneficiaryBankBranchName=ОСБ1
beneficiaryBankClearingCode.clearingCode=111111
beneficiaryBankClearingCode.countryCode=UA
beneficiaryBankClearingCode.shortName=Сокращенное наименование национального клирингового кода
beneficiaryBankClearingCode.symbol=UA
beneficiaryBankCountryDigital=643
beneficiaryBankCountryIso2=RU
beneficiaryBankName=ПАО СБЕРБАНК
beneficiaryBankPlace=MOSKVA
beneficiaryBankSwift=ABNARUMMSPB
beneficiaryBeiCode=AAAAAAAA
beneficiaryCountryDigital=643
beneficiaryCountryIso2=RU
beneficiaryCountryName=Россия
beneficiaryInn=222201236445
beneficiaryName=EMIRP
beneficiaryPlace=MOSKVA
chargesType=BEN
date=2019-11-26
externalId=fa1dabed-d7c4-42c3-9c59-25cbf4724765
iMediaBankAddress=SWEDEN HOUSE
iMediaBankCountryDigital=643
iMediaBankCountryIso2=RU
iMediaBankName=ABN AMRO BANK A.O.
iMediaBankPlace=ST. PETERSBURG
iMediaBankSwift=ABNARUMMSPB
iMediaClearingCode.clearingCode=111111
iMediaClearingCode.countryCode=UA
iMediaClearingCode.shortName=Сокращенное наименование национального клирингового кода
iMediaClearingCode.symbol=UA
iMediaFilialBankName=ОСБ1
inn=7494979410
option50a=K
option56a=A
option57a=A
option59a=A
orgName=Организация LCMdmYRFBCUflhq
payerAccount=40702840459430282265
payerAddress=UL.DOBROLIUBOVA,D.18,OF.III
payerBankBic=044525225
payerBankPlace=MOSKVA
payerCountryDigital=643
payerCountryIso2=RU
payerCountryName=Россия
payerName=LLC COMPANY
payerPlace=MOSKVA
paymentDetails=НАЗНАЧЕНИЕ ПЛАТЕЖА
paymentDirection=1
rateAgree=true
urgent=false
TABLES
Table=Codes23e
code=TELE
description=Описание
info=Дополнительная информация
#

Заполнение клиринговых кодов

Для задания массива клиринговых кодов банка бенефициара (beneficiaryBankClearingCode) или банка-посредника (iMediaClearingCode), используйте данные справочников:

  • Справочник структур национальных клиринговых кодов ClearingStructure для заполнения countryCode, shortName и symbol;

  • Международный справочник банков SwiftBic для заполнения clearingCode и countryCode.

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