ym88659208ym87991671
Создание валютного платежного поручения | Документация для разработчиков

Создание валютного платежного поручения

Обновлено 20 марта 2026

Запрос на создание валютного платежного поручения. Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка.

Для доступа к этому методу в параметре scope ссылки авторизации пользователя должен быть указан сервис PAY_DOC_CUR.

  • Если в запросе на создание платежного документа передать ЭП к документу (объект digestSignatures), то Банк сразу начнет обработку документа.
  • Если в запросе не передавать ЭП к документу, то платежное поручение будет создано в статусе черновик. Для начала обработки документа Банком потребуется зайти в интерфейс СберБизнес и подписать его.
Дайджест

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

Формат дайджеста запроса на создание валютного платежного поручения (значения 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.

Рекомендации по тестированию в песочнице

При тестировании создания валютного платежного поручения в Песочнице соблюдайте правила:

  • Генерируйте уникальный externalId для каждого документа.
  • Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (certificateUuid).
  • Все остальные поля запроса заполняйте произвольными данными (реквизиты, суммы, назначение платежа) в соответствии с требованиями в документации.

Сценарии тестирования

Для тестирования сценариев используйте фиксированные значения certificateUuid. При использовании любых других значений certificateUuid вернется ошибка WORKFLOW_FAULT "Проверьте актуальность сертификата электронной подписи."


1. Чтобы создать неподписанное платежное поручение (черновик), отправьте запрос без объекта digestSignatures.

Статус в ответе: bankStatus: "CREATED"

2. Для отправки документа с единственной подписью передайте в объекте digestSignatures тестовый UUID единоличного исполнительного органа (ЕИО).

Параметры:

  • certificateUuid: bb014b5d-8159-40be-97c1-eafeed4a8c3d

Статус в ответе: bankStatus: "IMPLEMENTED"

Пример:

  "digestSignatures": [
    \{
      "certificateUuid": "bb014b5d-8159-40be-97c1-eafeed4a8c3d",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],

3. Для отправки документа с двумя подписями передайте в объекте digestSignatures тестовые UUID первой И второй подписи.

Параметры:

  • certificateUuid: d5d4f811-f4d4-4205-a70f-58f772eeab72 (Первая подпись)
  • certificateUuid: 4f29c8ef-b55d-43c7-a321-f2b1303a29cd (Вторая подпись)

Статус в ответе: bankStatus: "IMPLEMENTED"

Пример:

  "digestSignatures": [
    \{
      "certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \},
    \{
      "certificateUuid": "4f29c8ef-b55d-43c7-a321-f2b1303a29cd",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],

4. Для отправки документа с одной из двух подписей передайте в объекте digestSignatures тестовые UUID первой ИЛИ второй подписи.

Статус в ответе: bankStatus: "PARTSIGNED"

Параметры:

  • certificateUuid: d5d4f811-f4d4-4205-a70f-58f772eeab72 (Первая подпись)
  • certificateUuid: 4f29c8ef-b55d-43c7-a321-f2b1303a29cd (Вторая подпись)

Пример:

  "digestSignatures": [
    \{
      "certificateUuid": "d5d4f811-f4d4-4205-a70f-58f772eeab72",
      "base64Encoded": "MIILDgYJKoZIhvcNAQcCoIIK..."
    \}
  ],

Запрос

Ответы

Успешный ответ

Loading...
Это полезный материал?
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей. Вы можете запретить сохранение cookie в настройках своего браузера.