Пром GET https://baas.alfabank.ru/api/semp/v1/payouts
Песочница GET https://sandbox.alfabank.ru/api/semp/v1/payouts
Scope
as-receipt-and-payout, as-receipt, as-payout-with-check-status, as-payout
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow
application/json
application/json
Дата создания выплаты
Количество объектов на одной странице
curl -X GET https://baas.alfabank.ru/api/semp/v1/payouts?creationDate=2023-10-12&limit=1 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token} \
-H 'Content-Type: application/json'
Параметры ответа
{
"pagination": {
"limit": 1,
"offset": 0,
"totalCount": 1
},
"payoutsList": [
{
"payoutId": "79df707d-cf78-4144-bc5c-43d2c9d3e71e",
"vatin": "0483685159",
"requestId": "8f9a2207-2114-4cc0-a832-9549749522af",
"externalId": "f8c1ffe6-696b-4e35-994f-904a9187806d",
"payerAccountNumber": "40702810301100003245",
"createdDate": "2024-04-24T11:23:16.419521Z",
"payoutRequisite": {
"payoutType": "ACCOUNT",
"payoutTotalAmount": "10.00",
"byAccount": {
"purpose": "Курьерские услуги за период с 1.12.2020-20",
"comment": "Курьерские услуги за период с 1.12.2020-20.12.2020Курьерские услуги за",
"accountNumber": "40817810010210029719",
"bic": "044525593",
"incomeTypeCode": "1"
}
},
"receiptRequisite": {
"customerVatin": "0483685159",
"customerName": "Полное наименование Орг № 89727",
"incomeType": "FROM_LEGAL_ENTITY",
"operateDate": "2024-04-11T10:36:42.855Z",
"requestDate": "2024-04-12T15:36:30.763Z",
"services": [
{
"amount": "23.00",
"name": "Курьерс",
"quantity": "1"
}
],
"receiptTotalAmount": "23.00"
},
"receiptLink": {
"receiptId": "207wvndu2q",
"link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/089469330539/207wvndu2q/print"
},
"receiptStatus": {
"status": "READY"
},
"payoutStatus": {
"status": "PAYMENT_IN_PROGRESS",
"updatedDate": "2024-04-24T11:24:01.0401Z"
}
]
}
Количество записей на одной странице
Количество записей в списке, которые были пропущены
Общее количество записей
Внешний идентификатор запроса, переданный Клиентом
Уникальный идентификатор
ИНН самозанятого
Номер счета
Дата и время создания запроса в системе
Тип выплаты. Принимает возможные значения: ACCOUNT
- Выплата по реквизитам счета получателя; CARD
- Выплата на банковскую карту получателя; PHONE
- Выплата через СБП по номеру телефона
Номер счета
БИК банка получателя
Назначение платежа
Код вида дохода получателей выплаты по 229-ФЗ
Комментарий к платежу
Номер карты получателя в зашифрованном виде
Комментарий к платежу
Телефон
Идентификатор банка получателя
Комментарий к платежу
Сумма выплаты
ИНН покупателя
Наименование компании покупателя
Тип дохода. Принимает возможные значения: FROM_INDIVIDUAL
- Доход от физического лица; FROM_LEGAL_ENTITY
- Доход от юридического лица или ИП; FROM_FOREIGN_AGENCY
- Доход от иностранной организации
Дата расчета с самозанятым, которая будет указана в чеке
Дата запроса на формирование чека
Цена услуги
Наименование услуги для регистрации дохода
Количество услуг. Согласно текущей спецификации ФНС всегда должно быть равно 1
Сумма чека
Идентификатор чека в ФНС
Ссылка на чек с сайта ФНС
Статус чека в системе. Принимает возможные значения: NEW
- Принят для последующей обработки; READY
- Успешно зарегистрирован; FAILED
- Ошибка в процессе регистрации или сторнирования; IN_PROGRESS
- В процессе регистрации; CANCELED_BY_CLIENT
- Аннулирован Клиентом; CANCELED_AUTOMATICALLY
- Аннулирован автоматически системой; FAILED_CANCEL
- Ошибка в процессе аннулирования; CANCELED_IN_PROGRESS
- В процессе аннулирования; CANCEL_REQUESTED
- Запрос на аннулирование чека отправлен в ФНС; CANCEL_INCOME_REQUESTED_AUTOMATICALLY
- Отправлен запрос в ФНС на аннулирование чека; CHECK_REFUND
- Проконтролируйте возврат суммы сторнированного дохода на счет; PARTNER_INFO
- Чек был передан клиентом; ALREADY_CANCELED
- Чек уже был отменен
Дата и время обновления статуса чека в системе
Статус выплаты в системе. Принимает возможные значения: NEW
- Принята для последующей обработки; READY
- Успешно исполнена; FAILED
- Ошибка в процессе исполнения; IN_PROGRESS
- В процессе исполнения; WAITING
- Ожидает поступления средств; BIND_CHECKED
- Проверка привязки самозанятого к компании успешна; SELFEMPLOYED_CHECKED
- Проверка самозанятого успешна; BALANCE_CHECKED
- Баланса достаточно; SELFEMPLOYED_TAXPAYER_CHECK
- Статус самозанятого проверяется в ФНС; PAYMENT_IN_PROGRESS
- Выплата в обработке; INCOME_REGISTRATION_REQUESTED
- Отправлен запрос в ФНС на регистрацию чека; TECHNICAL_ERROR
- Техническая ошибка; FAILED_SELFEMPLOYED_CHECK
- Самозанятый не имеет статус; READY
- Успешно исполнена; FAILED_SELFEMPLOYED_TAXPAYER_CHECK
- Самозанятый не прошел проверку статуса в ФНС; FAILED_BIND_CHECK
- Самозанятый не привязан к компании; FAILED_EQ_ACCOUNT_PAY
- Внутренняя ошибка выплаты в Банке; REGISTRATION_RESTRICTIONS_IN_PROGRESS
- Статус самозанятого в процессе проверки в ФНС; FULL_NAME_CHECKED
- ФИО проверено; FAILED_FULL_NAME_CHECK
- Проверка ФИО неуспешна; PAYMENT_DEFERRED
- Проведение выплаты отложена; AWAIT_EXTERNAL
- Внешний платеж ожидает исполнения; COMPLIANCE_CHECKED
- Комплаенс проверка пройдена; FAILED_COMPLIANCE
- Комплаенс проверка не была пройдена; FAILED_SIGNATURE
- Подпись не прошла проверку; SIGNATURE_CHECKED
- Подпись проверена
Дата и время обновления статуса выплаты в системе
Наменование поля в котором возникла ошибка
Описание ошибки
{
"pagination": {
"limit": 1,
"offset": 0,
"totalCount": 1
},
"payoutsList": [
{
"payoutId": "79df707d-cf78-4144-bc5c-43d2c9d3e71e",
"vatin": "0483685159",
"requestId": "8f9a2207-2114-4cc0-a832-9549749522af",
"externalId": "f8c1ffe6-696b-4e35-994f-904a9187806d",
"payerAccountNumber": "40702810301100003245",
"createdDate": "2024-04-24T11:23:16.419521Z",
"payoutRequisite": {
"payoutType": "ACCOUNT",
"payoutTotalAmount": "10.00",
"byAccount": {
"purpose": "Курьерские услуги за период с 1.12.2020-20",
"comment": "Курьерские услуги за период с 1.12.2020-20.12.2020Курьерские услуги за",
"accountNumber": "40817810010210029719",
"bic": "044525593",
"incomeTypeCode": "1"
}
},
"receiptRequisite": {
"customerVatin": "0483685159",
"customerName": "Полное наименование Орг № 89727",
"incomeType": "FROM_LEGAL_ENTITY",
"operateDate": "2024-04-11T10:36:42.855Z",
"requestDate": "2024-04-12T15:36:30.763Z",
"services": [
{
"amount": "23.00",
"name": "Курьерс",
"quantity": "1"
}
],
"receiptTotalAmount": "23.00"
},
"receiptLink": {
"receiptId": "207wvndu2q",
"link": "https://lknpd-adp.gnivc.ru/api/v1/receipt/089469330539/207wvndu2q/print"
},
"receiptStatus": {
"status": "READY"
},
"payoutStatus": {
"status": "PAYMENT_IN_PROGRESS",
"updatedDate": "2024-04-24T11:24:01.0401Z"
}
]
}
Код ошибки. Принимает возможные значения: invalid_request
- Неверные входные параметры запроса
Описание ошибки
{
"error": "invalid_request",
"error_description": "Authorization header is not present in request headers"
}
Код ошибки. Принимает возможные значения: invalid_token
- Предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
Описание ошибки
{
"error": "invalid_token",
"error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}
Код ошибки. Принимает возможные значения: insufficient_scope
- У пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; access_denied
- Доступ к счету запрещен
Описание ошибки
{
"error": "insufficient_scope",
"error_description": "The request requires higher privileges than provided by the access token"
}
Код ошибки. Принимает возможные значения: internal_error
- Внутренняя ошибка сервиса при выполнении обработки запроса
Описание ошибки
{
"error": "internal_error",
"error_description": "Internal server error"
}
Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.