Version: 1.0.0
Pay-Doc-Cur Overview
Обновлено 9 октября 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.currencyName | ISO-код валюты | 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 |
| beneficiaryBankCountryIso2 | 2х буквенный ISO-код страны банка бенефициара | RU |
| beneficiaryBankName | Наименование банка бенефициара | ПАО СБЕРБАНК |
| beneficiaryBankPlace | Местонахождение банка бенефициара | MOSKVA |
| beneficiaryBankSwift | SWIFT-код банка бенефициара | ABNARUMMSPB |
| beneficiaryBeiCode | BEI-код (SWIFT-код) | AAAAAAAA |
| beneficiaryCountryDigital | Цифровой код страны бенефициара | 643 |
| beneficiaryCountryIso2 | 2х буквенный ISO-код страны бенефициара | RU |
| beneficiaryCountryName | Наименование страны бенефициара на русском языке (краткое наименование) | Россия |
| beneficiaryInn | ИНН бенефициара | 222201236445 |
| beneficiaryName | Наименование бенефициара | EMIRP |
| beneficiaryPlace | Город (месторасположение) бенефициара | MOSKVA |
| chargesType | Тип комиссии за перевод: BEN, SHA или OUR | BEN |
| date | Дата документа | 2019-10-16 |
| externalId | Идентификатор документа в организации-партнере (UUID) | 619e25cf-dc0b-4420-8957-1b94bf29f145 |
| iMediaBankAddress | Адрес банка-посредника | SWEDEN HOUSE |
| iMediaBankCountryDigital | Цифровой код страны банка-посредника | 643 |
| iMediaBankCountryIso2 | 2х буквенный ISO-код страны банка-посредника | RU |
| iMediaBankName | Наименование банка-посредника | ABN AMRO BANK A.O. |
| iMediaBankPlace | Город банка-посредника | ST. PETERSBURG |
| iMediaBankSwift | SWIFT-код банка-посредника | 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 |
| payerCountryIso2 | 2х буквенный ISO-код страны перевододателя | RU |
| payerCountryName | Наименование страны перевододателя на русском языке (краткое наименование) | Россия |
| payerName | Международное наименование плательщика | LLC COMPANY |
| payerPlace | Город (местонахождение) плательщика | MOSKVA |
| paymentDetails | Назначение платежа | ABCD |
| paymentDirection | Направление платежа (Платеж внутри или вне СБРФ): 1-внутри, 0-вне | 1 |
| rateAgree | С курсом проведения конверсионной операции согласны | true |
| urgent | Срочность | false |
| TABLES | ||
| Table | 23E: Код инструкции | 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.