Alfa API: Создать и проконтролировать платёжное поручение

Сценарий из mcp-everything. Актуально на 2026-10-13.

Создаёт рублёвое платёжное поручение по собственному счёту или счёту клиента и позволяет дождаться банковского статуса. Перевод возможен только на счёт резидента РФ.

  1. Подключи scope payment, получи access_token и сгенерируй уникальный externalId в формате UUID.
  2. Создай документ: POST /api/jp/v2/payments. Чтобы передать электронную подпись вместе с документом, добавь digestSignatures; без подписи документ сохраняется в начальном статусе и ожидает подписания в Альфа-Бизнес.
  3. Если документ подписан не в запросе, подпиши его в Альфа-Бизнес.
  4. Проверяй обработку: GET /api/jp/v2/payments/{externalId}/state. В ответе придут bankStatus, bankComment и crucialFieldsHash.
  5. Если нужно убедиться, что реквизиты получателя не изменились до появления выписки, сравни crucialFieldsHash из ответов создания и проверки статуса.
curl --location 'https://sandbox.alfabank.ru/api/jp/v2/payments' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
    "amount": 1.01,
    "date": "2022-10-11",
    "deliveryKind": "электронно",
    "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
    "operationCode": "01",
    "payeeAccount": "40702810564564564531",
    "payeeBankBic": "040173745",
    "payeeName": "{payeeName}",
    "payerAccount": "40702810102300000001",
    "payerBankBic": "044525593",
    "payerBankCorrAccount": "30101810200000000593",
    "payerInn": "7736576798",
    "payerName": "{payerName}",
    "priority": "5",
    "purpose": "Оплата заказа №1. НДС не облагается"
  }'

Базовые URL

Авторизация

Тип: OAuth 2.0

Alfa ID использует OAuth 2.0/OIDC. Для Authorization Code Flow нужны client_id, client_secret, redirect_uri и scopes подключённых продуктов; токен передаётся в заголовке Authorization: Bearer {access_token}. Alfa ID подходит для всех типов интеграций и продуктов.

Для части B2B- и H2H-методов доступен API Key: передавай Authorization: ApiKey {API Key}. Внутренний ключ предназначен для операций по своей компании, внешний — по другой компании; API Key доступен не для всех продуктов, поэтому проверяй описание конкретного метода.

Методы сценария

POST /api/jp/v2/payments — Создание рублёвого платёжного поручения

Создаёт поручение по собственному счёту или счёту клиента. Требует scope payment и Bearer-токен.

Документация: https://developers.alfabank.ru/products/alfa-api/documentation/articles/payments/articles/create/v2/create

Параметр Где Тип Обяз. Описание
Authorization header string да Bearer {access_token}
Accept header string да application/json
Content-Type header string да application/json
amount body number да Сумма платежа
date body string да Дата документа, YYYY-MM-DD
externalId body string да Идентификатор документа партнёра, UUID
operationCode body string да 01 — платёжное поручение
payeeAccount body string да Счёт получателя
payeeBankBic body string да БИК банка получателя
payeeName body string да Полное наименование получателя
payerAccount body string да Счёт плательщика
payerBankBic body string да БИК банка плательщика
payerBankCorrAccount body string да Корсчёт банка плательщика
payerInn body string да ИНН плательщика
payerName body string да Полное наименование плательщика
priority body string да Очерёдность платежа: 1–5
purpose body string да Назначение платежа, не больше 210 символов
digestSignatures body array нет Электронные подписи по дайджесту документа
digestSignatures.base64Encoded body string да Значение ЭП в Base64, если передан элемент массива
digestSignatures.certificateUuid body string нет Серийный номер RSA-сертификата

Пример ответа:

{
  "amount": 1,
  "bankComment": "",
  "bankStatus": "CREATED",
  "crucialFieldsHash": "3ba4cecce366c3ad8db6edafb71052b37a8a1acc8013ff565879d8711c0c4316",
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6"
}

GET /api/jp/v2/payments/{externalId}/state — Получение статуса платёжного поручения

Возвращает банковский статус, комментарий и хэш ключевых реквизитов документа. Требует scope payment.

Документация: https://developers.alfabank.ru/products/alfa-api/documentation/articles/payments/articles/status/v2/status

Параметр Где Тип Обяз. Описание
Authorization header string да Bearer {access_token}
Accept header string да application/json
externalId path string да Идентификатор документа партнёра, UUID

Пример ответа:

{
  "bankStatus": "ACCEPTED",
  "bankComment": "Отправим платёж в течение банковского дня",
  "crucialFieldsHash": "3ba4cecce366c3ad8db6edafb71052b37a8a1acc8013ff565879d8711c0c4316"
}

Нюансы

Другие сценарии

Если этого недостаточно — официальная документация: https://developers.alfabank.ru/products/alfa-api/documentation Вся интеграция одним документом: https://mcp-everything.ru/integrations/alfa-bank-api.md