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

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

Скачать спецификацию

Запрос на создание рублевого платежного поручения (РПП).

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

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

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

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

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

• Не нужно устанавливать промышленные сертификаты электронной подписи (ЭП) — Песочница использует тестовые идентификаторы ЭП (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..."
    }
  ],

Запрос

Ответы

Успешный запрос перевода

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

Cause	Message	Description
DESERIALIZATION_FAULT	Неверный формат запроса	Данные в request указаны в неправильном формате. Атрибуты request, в которых найдены ошибки, указаны в response в массиве fields с описанием проблемы. Описание типа, формата и regexp атрибутов находится в request запроса. Скорректируйте заполнение атрибутов и повторите запрос.
VALIDATION_FAULT	Ошибка валидации	Данные не соответствуют требованиям валидации. Сведения о некорректных атрибутах request содержатся в массивах fieldNames и checks. Подробные требования к атрибутам описаны в request запроса, включая типы, форматы и регулярные выражения. Необходимо скорректировать заполнение атрибутов и повторить запрос.
WORKFLOW_FAULT	Ошибка бизнес-процесса	Данные не соответствуют логике бизнес- процесса. Сведение об ошибке содержится в message (например, отсутствие требуемых объектов (организаций, счетов, реквизитов банков), невозможность их идентификации, дублирование уникальных идентификаторов. Необходимо скорректировать заполнение атрибутов и повторить запрос.

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

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, не указана операция PAY_DOC_RU. Необходимо добавить одному или несколько операций в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token.

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

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

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

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

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

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

Скачать спецификацию

Loading...