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.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
.