H2H

Создание запроса на выплату с номинального счёта

Песочница
POST https://sandbox.alfabank.ru/api/na/jp/v1/payoffs
Пром
POST https://baas.alfabank.ru/api/na/jp/v1/payoffs
Scope

beneficiary-payments

Описание

Метод позволяет вывести собственные средства бенефициара с номинального счёта по заранее зарегистрированным платёжным реквизитам (с биллингом) или осуществить выплату зарегистрированным контрагентам (без биллинга).

Заполнение полей запроса зависит от типа выплаты. Примеры запроса для разных типов выплат можно посмотреть в подразделе «Примеры запросов для различных типов выплат» этой статьи.

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

application/json

Content-Type
stringrequired

application/json

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

Тип платежа. Возможные значения:

  • •
    REGULAR - обычный платёж (с биллингом и без);
  • •
    DEAL - платёж внутри сделки;
  • •
    TAX_REFUND - возврат налоговых средств;
  • •
    TRANSACTION_REFUND - возврат неидентифицированного пополнения;
  • •
    TAX - налоговый платёж
accountNumber
stringrequired

Номер номинального счёта

deponent
stringoptional

Идентификатор бенефициара-плательщика

objectrequired

Получатель

type
stringrequired

Тип получателя. Возможные значения:

  • •
    BENEFICIARY - контрагент;
  • •
    SIMPLE_PAYEE - простой получатель
name
stringoptional

Наименование получателя. Поле обязательно, если тип получателя равен SIMPLE_PAYEE.

  • •
    Для ФЛ - ФИО;
  • •
    Для ЮЛ - наименование организации;
  • •
    Для ИП - наименование для ИП
inn
stringoptional

ИНН получателя. Поле обязательно, если тип получателя равен SIMPLE_PAYEE.

  • •
    Для ФЛ и ИП - 12 цифр;
  • •
    Для ЮЛ - 10 цифр
kpp
stringoptional

КПП получателя. Заполняется, если тип получателя равен SIMPLE_PAYEE

beneficiaryId
stringoptional

Идентификатор контрагента-получателя. Поле обязательно, если тип получателя равен BENEFICIARY

objectoptional

Реквизиты обычного платежа

type
stringrequired

Тип платёжного реквизита. Возможные значения:

  • •
    ACCOUNT - реквизиты счёта;
  • •
    CARD - номер карты (токен);
  • •
    PHONE - номер телефона;
  • •
    BENEFICIARY_REQUISITE - идентификатор реквизитов контрагента
requisiteId
stringoptional

Идентификатор реквизитов контрагента-получателя. Поле обязательно, если тип реквизитов равен BENEFICIARY_REQUISITE

pan
stringoptional
keyId
stringoptional

Идентификатор публичного ключа для расшифровки токена номера карты

phoneNumber
stringoptional

Номер телефона. Поле обязательно, если тип реквизитов равен PHONE

bankId
stringoptional

Идентификатор банка контрагента-получателя. Поле обязательно, если тип реквизитов равен PHONE

accountNumber
stringoptional

Номер счёта. Поле обязательно, если тип реквизитов равен ACCOUNT

bik
stringoptional

БИК банка. Поле обязательно, если тип реквизитов равен ACCOUNT

objectoptional

Реквизиты для налогового платежа

accountNumber
stringrequired

Номер счёта

bik
stringrequired

БИК банка

name
stringrequired

Наименование получателя

inn
stringrequired

ИНН получателя

kpp
stringrequired

КПП получателя

amount
integerrequired

Сумма в рублях

purpose
stringrequired

Назначение платежа, которое будет отображено в выписке. Максимальная длина:

  • •
    в случае выплат по реквизитам счёта - 210 символов;
  • •
    в случае выплат по номеру карты - 200 символов;
  • •
    в случае выплат по СБП резидентам - 110 символов;
  • •
    в случае выплат по СБП нерезидентам - 92 символа
objectoptional

Параметры для налогового платежа

uin
stringrequired

Уникальный идентификатор начисления (поле платёжки - 22)

payerStatus
stringrequired

Статус составителя расчётного документа (поле платёжки - 101). При оплате налога за третьих лиц указывается налоговый статус человека, за которого происходит оплата. Возможные значения:

  • •
    01 - налогоплательщик (плательщик сборов) - юрлицо;
  • •
    02 - налоговый агент;
  • •
    08 - плательщик-юрлицо (ИП), осуществляющий уплату страховых взносов и иных платежей в бюджетную систему РФ;
  • •
    13 - физическое лицо, уплачивающее налоги, сборы за совершение налоговыми органами юридически значимых действий, страховые взносы и иные платежи, администрируемые налоговыми органами;
  • •
    14 - указывается плательщиком, который осуществляет транзакции в пользу физлиц;
  • •
    19 - организации и их филиалы, перечисляющие средства, удержанные из заработной платы (дохода) должника - физлица в счёт погашения задолженности по платежам в бюджет на основании исполнительного документа;
  • •
    24 - плательщик-физлицо, осуществляющий уплату страховых взносов и иных платежей в бюджетную систему РФ
kbk
stringrequired

Код бюджетной классификации (поле платёжки - 104)

oktmo
stringrequired

Код ОКТМО территории, на которой мобилизуются денежные средства от уплаты налога, сбора и иного платежа (поле платёжки - 105)

reason
stringrequired

Основание налогового платежа (поле платёжки - 106). Возможные значения:

  • •
    ТП - платежи текущего года;
  • •
    ЗД - добровольное погашение задолженности по истекшим налоговым, расчётным (отчётным) периодам при отсутствии требования налогового органа об уплате налогов (сборов);
  • •
    РС - погашение рассроченной задолженности;
  • •
    ОТ - погашение отсроченной задолженности;
  • •
    РТ - погашение реструктурируемой задолженности;
  • •
    ПБ - погашение должником задолженности в ходе процедур, применяемых в деле о банкротстве;
  • •
    ИН - погашение инвестиционного налогового кредита;
  • •
    ТЛ - погашение учредителем (участником) должника или собственником имущества должника - унитарного предприятия или третьим лицом задолженности в ходе процедур, применяемых в деле о банкротстве;
  • •
    ЗТ - погашение текущей задолженности в ходе процедур, применяемых в деле о банкротстве;
  • •
    00 - иные случаи (для таможенных платежей);
  • •
    0 - при незнании основания платежа
period
stringrequired

Налоговый период (поле платёжки - 107). Формат - ДД.ММ.ГГГГ, первые два символа могут быть буквами или цифрами. В поле можно передать 0

docNumber
stringrequired

Номер налогового документа (поле платёжки - 108)

docDate
stringrequired

Дата налогового документа (поле платёжки - 109). Формат - ДД.ММ.ГГГГ. В поле можно передать 0

paymentKind
stringoptional

Код типа налогового платежа (поле платёжки - 110). Поле можно оставить пустым или передать 0. Возможные значения:

  • •
    ПЕ - уплата пени;
  • •
    ПЦ - уплата процентов
array of objectsrequired

Электронная подпись УЛ клиента

base64Encoded
stringrequired

Значение электронной подписи, закодированное в Base64

signatureType
stringrequired

Тип электронной подписи. Возможные значения:

  • •
    RSA - RSA;
  • •
    KEP - КЭП
Пример запроса
Язык 
1curl --location 'https://baas.alfabank.ru/api/na/jp/v1/payoffs' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6  "type": "REGULAR",
7  "accountNumber": "40817810306050000000",
8  "deponent": "ab9cbb96-360a-4462-a683-955cc29f7f54",
9  "recipient": {
10    "type": "BENEFICIARY",
11    "beneficiaryId": "cd9cbb96-360a-4462-a683-955cc29f7f55"
12  },
13  "payoutRequisite": {
14    "type": "ACCOUNT",
15    "accountNumber": "40817810306050000000",
16    "bik": "044525593"
17  },
18  "amount": 10000,
19  "purpose": "Оплата по договору №123 от 01.04.2025",
20  "digestSignatures": [
21    {
22      "base64Encoded": "SEwHwYDVQQDExhDUllQVE8tUFJPIFRlc3QgQ2VudGVyIDICExIAVH4YMX0u3fEONSkAAQBUfhgwCgYIKoUDBwEBAQEEQBU0EntPGWz8EfJ5CFL2m10xeBrkAEeWDglGQDZWLKQ0ff4TyBT9X1NhG/+ETj4TcQhExy6k+WZ9w/CpF5FjyyA=",
23      "signatureType": "RSA"
24    }
25  ]
26}'
Параметры ответа
Пример ответа 202 (Accepted) 
1{
2  "payoffId": "ab9cbb96-360a-4462-a683-955cc29f7f54",
3  "status": "PENDING"
4}
BODY
атрибут
описание
payoffId
stringrequired

Идентификатор платежа

status
stringrequired

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

  • •
    PENDING - запрос в процессе обработки;
  • •
    MANUAL_ACCEPTANCE - ожидание ручного подтверждения отправки запроса-дубля на обработку;
  • •
    AWAIT_EXTERNAL - ожидание исполнения внешнего платежа;
  • •
    FAILED - обработка запроса завершилась ошибкой;
  • •
    FAILED_DUPLICATE - обработка запроса-дубля отклонена;
  • •
    COMPLETE - обработка запроса завершилась успешно
Пример ответа 202 (Accepted) 
1{
2  "payoffId": "ab9cbb96-360a-4462-a683-955cc29f7f54",
3  "status": "PENDING"
4}
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 - при запросе кода авторизации не были переданы все необходимые scopes. Необходимо переподписать договор согласия, повторно отправив запрос на получение кода авторизации с указанием всех доступных scopes и параметра prompt=consent
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 - эндпоинт не найден или неактивен
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

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

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

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

Пример ошибки 500 (Internal Server Error) 
1{
2  "error": "internal_error",
3  "error_description": "Internal server error"
4}
Нет тела ответа
Примеры запросов для различных типов выплат

Ниже приведены примеры JSON тела запроса для различных сценариев выплат, определяемых комбинацией полей type, recipient и payoutRequisite.

Вывод собственных средств бенефициара

Пример вывода средств бенефициара (владельца бизнеса) на его платёжные реквизиты, которые были заранее зарегистрированы в системе. Платёж происходит без оформления сделки.

Вывод собственных средств бенефициара 
1{
2    "type": "REGULAR",
3    "accountNumber": 40702810901990035810,
4    "recipient": {
5        "type": "BENEFICIARY",
6        "beneficiaryId": "020eb636-bc54-4872-bc25-a7f880004286"
7    },
8    "payoutRequisite": {
9        "type": "BENEFICIARY_REQUISITE",
10        "requisiteId": "f1bfaf66-fe78-4d2c-aadc-8ad4f1fbcaa6"
11    },
12    "digestSignatures": [
13        {
14            "base64Encoded": "MIIHioBJI",
15            "signatureType": "RSA"
16        }
17    ],
18    "amount": "12.00",
19    "purpose": "Внутренний перевод по реквизитам без оформления сделки"
20}

Выплата бенефициару

Пример выплаты зарегистрированному в системе бенефициару, но не на его ранее зарегистрированные платёжные реквизиты, а на указанные в запросе банковский счёт или номер карты, без оформления сделки. Это может быть удобно для разовых выплат.

Выплата бенефициару 
1{
2    "type": "REGULAR",
3    "accountNumber": "40702810901990035810",
4    "recipient": {
5        "type": "BENEFICIARY",
6        "beneficiaryId": "2a809c34-e630-4477-9458-3144f9467cef"
7    },
8    "payoutRequisite": {
9        "type": "ACCOUNT",
10        "accountNumber": "40817810610214388186",
11        "bic": "044525593"
12    },
13    "amount": "2650.00",
14    "purpose": "Назначение платежа",
15    "digestSignatures": [
16        {
17            "base64Encoded": "MIIHhQYJKoZIhvcNAQcCoIIHdjCCB3ICAQEX+rPG4r2eCUD4k1lACQioBJI",
18            "signatureType": "RSA"
19        }
20    ]
21}

Простая выплата юридическому лицу на счёт

Пример выплаты стороннему юридическому лицу (не бенефициару), идентифицируемому по ИНН/КПП, на его расчетный счёт:

Простая выплата юридическому лицу на счёт 
1{
2    "type": "REGULAR",
3    "accountNumber": "40702810601990014393",
4    "recipient": {
5        "type": "SIMPLE_PAYEE",
6        "name": "Полное наименование Орг № 97165",
7        "inn": "2230211183",
8        "kpp": "053586247"
9    },
10    "payoutRequisite": {
11        "type": "ACCOUNT",
12        "accountNumber": "40702810901990035810",
13        "bic": "044525593"
14    },
15    "amount": "315.00",
16    "purpose": "проверка поля",
17    "digestSignatures": [
18        {
19            "base64Encoded": "bmNranNkbmNranNuY2prbmpmY2tkcw==",
20            "signatureType": "RSA"
21        }
22    ]
23}

Выплата с целью уплаты налога на профессиональный доход за исполнителя

Пример выплаты для уплаты налогов, сборов и других обязательных платежей в бюджетную систему РФ:

Выплата с целью уплаты налога на профессиональный доход за исполнителя 
1{
2    "type": "TAX",
3    "accountNumber": "40702810901990035810",
4    "deponent": "2a809c34-e630-4477-9458-3144f9467cef",
5    "requisites": {
6        "accountNumber": "03100643000000018500",
7        "bic": "017003983",
8        "name": "Казначейство  России (ФНС России)",
9        "inn": "7727406020",
10        "kpp": "770801001"
11    },
12        "tax":{
13        "payerStatus":"01",
14        "kbk":"12345678901234567890",
15        "oktmo":"0",
16        "reason":"0",
17        "period":"0",
18        "docNumber":"0",
19        "docDate":"0",
20        "uin":"18209997240000004997",
21        "paymentKind":"0"
22    },
23    "amount": "143.00",
24    "purpose": "2235596183//053586247//ИВАНОВ ИВАН БОРИСОВИЧ//Единый налоговый платёж. НДС не облагается",
25    "digestSignatures": [
26        {
27            "base64Encoded": "MIIHhQYJKoZIhvcNAQcCoIIHdjCCB3ICAQExDTALBglghkgBZQMEAgEwgcoGCSqGSIb3DQEHAaCBvASBuXsiYWN0aW9uIjoiQ09NUExFVEUiLCJkZWFsSWQiOiJjZTRhZWIzYi1jZDdkLTQwMzUtODU1NS05MDNjYTkwNzVjNjgiLCJkZXNjcmlwdGlvbiI6ItCX0LDQstC10YDRiNC40YWQo9vSGxyeHL/yblFY6AT/4cMZBfbreGgMYlO9/298fLOQ7+po32laR2ZTEmOJ7Tk0FOy4M6dk8SN3ixJRnF6lizgBrtnk16W+K//126ViMuLX+rPG4r2eCUD4k1lACQioBJI",
28            "signatureType": "RSA"
29        }
30    ]
31}
Как это работаетПолучение статуса запроса на выплату с номинального счёта