B2BH2H

Изменение статуса платёжного поручения

Песочница
PATCH https://sandbox.alfabank.ru/api/jp/v2/payments/{externalId}/state
Пром
PATCH https://baas.alfabank.ru/api/jp/v2/payments/{externalId}/state
Scope

payment

Описание

Метод позволяет отправить платёжное поручение на подпись. После выполнения запроса платёж можно посмотреть на вкладке «На подпись» раздела «Платежи в работе» интерфейса Альфа-Бизнес.

Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

Content-Type
stringrequired

application/json

PATH
Атрибут
Описание
externalId
stringrequired

Идентификатор документа, присвоенный партнёром (UUID)

BODY
Атрибут
Описание
bankStatus
stringrequired

Статус документа. Возможные значения:

  • PARTSIGNED — отправлен на подпись или частично подписан
Пример запроса
Язык
1curl --location --globoff --request PATCH 'https://baas.alfabank.ru/api/jp/v2/payments/{externalId}/state' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6  "bankStatus": "PARTSIGNED"
7}'
Параметры ответа
Пример ответа 200 (OK)
1{
2  "bankStatus": "PARTSIGNED",
3  "bankComment": null,
4  "crucialFieldsHash": "3ba4cecce366c3ad8db6edafb71052b37a8a1acc8013ff565879d8711c0c4316"
5}
BODY
атрибут
описание
bankStatus
stringoptional

Статус документа. Принимает возможные значения:

  • PARTSIGNED — отправлен на подпись или частично подписан
bankComment
stringoptional

Банковский комментарий к статусу документа

crucialFieldsHash
stringoptional

Hash от ключевых полей документа

Пример ответа 200 (OK)
1{
2  "bankStatus": "PARTSIGNED",
3  "bankComment": null,
4  "crucialFieldsHash": "3ba4cecce366c3ad8db6edafb71052b37a8a1acc8013ff565879d8711c0c4316"
5}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_request — неверные входные параметры запроса
error_description
stringoptional

Описание ошибки

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_request",
3  "error_description": "Authorization header is not present in request headers"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_token — предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
error_description
stringoptional

Описание ошибки

Пример ошибки 401 (Unauthorized)
1{
2  "error": "invalid_token",
3  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • insufficient_scope — у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope
error_description
stringoptional

Описание ошибки

Пример ошибки 403 (Forbidden)
1{
2  "error": "insufficient_scope",
3  "error_description": "The request requires higher privileges than provided by the access token"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • unknown_endpoint — эндпоинт не найден или неактивен;
  • payment_not_found — платёж не найден
error_description
stringoptional

Описание ошибки

Пример ошибки 404 (Not Found)
1{
2  "error": "unknown_endpoint",
3  "error_description": "Endpoint is not found or not active"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • status_check_error — платёжное поручение находится в неподходящем для операции статусе
error_description
stringoptional

Описание ошибки

Пример ошибки 409 (Conflict)
1{
2  "error": "status_check_error",
3  "error_description": "The payment is in an unsuitable status for the operation"
4}
Нет тела ответа
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • internal_error — внутренняя ошибка сервиса при выполнении обработки запроса
error_description
stringoptional

Описание ошибки

Пример ошибки 500 (Internal Server Error)
1{
2  "error": "internal_error",
3  "error_description": "Internal server error"
4}
Нет тела ответа