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

Обновлено 15 апреля 2026

На данный момент метод доступен только на тестовом контуре. Информация о выводе в промышленный контур будет опубликована в истории изменений.

Запрос на создание поручения на покупку/продажу валюты

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

Дайджест

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

Дайджест формируется по коду атрибута в том же порядке, как указано в таблице. Если какое-то поле не заполнено (null), то в дайджест не попадает

Формат дайджеста запроса на создание поручения на покупку/продажу валюты:

Наименование поля	Описание поля	Пример
chargeData.account	Счет списания комиссии (в рублях). Необязательный атрибут. Формируется, если способ расчета - по курсу ЦБ РФ со взиманием комиссии	40702810657240000001
chargeData.isoCode	ISO-код валюты списания комиссии (код российского рубля). Необязательный атрибут. Формируется, если способ расчета - по курсу ЦБ РФ со взиманием комиссии	RUB
creditData.account	Счет зачисления. Обязательный атрибут	40702840657240000001
creditData.amount	Сумма зачисления. Необязательный атрибут. Формируется, если был передан при создании поручения	null
creditData.bic	БИК банка зачисления. Необязательный атрибут. Формируется, если счет зачисления открыт в другом банке	044525225
creditData.corrAccount	Корреспондентский счет банка зачисления. Необязательный атрибут. Формируется, если счет зачисления открыт в другом банке	30101810400000000225
creditData.isExternalAccount	Признак внешнего счета зачисления. Обязательный атрибут: false – счет зачисления открыт в Сбербанке, true – счет зачисления открыт в другом банке	true
creditData.isoCode	ISO-код валюты зачисления. Обязательный атрибут	USD
debitData.account	Счет списания. Обязательный атрибут	40702810657240000001
debitData.amount	Сумма списания. Необязательный атрибут. Формируется, если был передан при создании поручения	1000
debitData.isoCode	ISO-код валюты списания. Обязательный атрибут	RUB
generalData.date	Дата документа (в формате YYYY-MM-DD). Обязательный атрибут	2026-03-15
generalData.externalId	Идентификатор документа в системе партнера (UUID). Обязательный атрибут	25c34765-5792-43ed-9dec-2c0bb5ac5f48
generalData.isCharged	Способ расчета. Обязательный атрибут: false – расчет по курсу банка без комиссии, true – расчет по курсу ЦБ РФ со взиманием комиссии	true
generalData.number	Номер документа. Обязательный атрибут	956
orgData.inn	ИНН клиента. Обязательный атрибут	2569873456
orgData.name	Наименование клиента. Обязательный атрибут	ООО "Рога и копыта"

Примеры: Дайджест подписи для поручения на продажу валюты с внешним счетом зачисления и способом расчета по курсу ЦБ РФ со взиманием комиссии. На вход передана сумма списания.

chargeData.account=40702810657240000000
chargeData.isoCode=RUB
creditData.account=40702810657240000000
creditData.bic=044525593
creditData.corrAccount=30101810400000000000
creditData.isExternalAccount=true
creditData.isoCode=RUB
debitData.account=40702840657240000000
debitData.amount=1000
debitData.isoCode=USD
generalData.date=2026-03-03
generalData.externalId=25c34765-5792-43ed-9dec-2c0bb5ac5f48
generalData.isCharged=true
generalData.number=956
orgData.inn=2569873456
orgData.name=ООО "Рога и копыта"

Дайджест подписи для поручения на продажу валюты с внешним счетом зачисления. На вход передана сумма зачисления.

creditData.account=40702810657240000000
creditData.amount=50
creditData.bic=044525593
creditData.corrAccount=30101810400000000000
creditData.isExternalAccount=true
creditData.isoCode=RUB
debitData.account=40702840657240000000
debitData.isoCode=USD
generalData.date=2026-03-03
generalData.externalId=25c34765-5792-43ed-9dec-2c0bb5ac5f48
generalData.isCharged=false
generalData.number=956
orgData.inn=2569873456
orgData.name=ООО "Рога и копыта"

Дайджест подписи для поручения на покупку валюты на счет, открытый в ПАО Сбербанк. На вход передана сумма зачисления.

creditData.account=40702840657240000000
creditData.amount=50
creditData.isExternalAccount=false
creditData.isoCode=USD
debitData.account=40702810657240000000
debitData.isoCode=RUB
generalData.date=2026-03-03
generalData.externalId=25c34765-5792-43ed-9dec-2c0bb5ac5f48
generalData.isCharged=false
generalData.number=956
orgData.inn=2569873456
orgData.name=ООО "Рога и копыта"

Запрос

Ответы

Успешный запрос на создание поручения по покупке/продаже валюты

"Ошибка в запросе"

Cause	Message	Description
VALIDATION_FAULT	Ошибка валидации	Если в запросе отсутствуют обязательные параметры или переданы некорректные параметры
TECHNICAL_EXCEPTION	Техническая ошибка	Если возникли прочие технические ошибки
BUSINESS_EXCEPTION	Ошибка бизнес-процесса	Если возникли различные бизнес ошибки

"Не авторизован"

Cause	Message	Description
UNAUTHORIZED	accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х	Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос.

"Операция не может быть выполнена: доступ к ресурсу запрещен"

Cause	Message	Description
ACTION_ACCESS_EXCEPTION	Операция не может быть выполнена: доступ к ресурсу запрещен	Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope, не указана операция CONVERSION_OPERATION_CURRENCY. Необходимо добавить одному или несколько операций в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.

"Ошибка валидации запроса"

Cause	Message	Description
VALIDATION_FAULT	Валидация запроса завершилась ошибкой	Модель запроса не прошла валидацию на SOWA

"Превышен лимит запросов"

Cause	Message	Description
TOO_MANY_REQUESTS	Превышен лимит запросов. Повторите операцию позже.	Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее

"Внутренняя ошибка сервера"

Cause	Message	Description
UNKNOWN_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

"Сервис временно недоступен"

Cause	Message	Description
UNAVAILABLE_RESOURCE_EXCEPTION	Внутренняя ошибка сервера	Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка.

Loading...