Documentation

Documentation

  • API Банка 131
  • Languages iconРусский
    • English

›Самозанятые

Документация

  • Возможности API
  • С чего начать

Работа с API

  • Формат работы
  • Библиотеки
  • Тестирование
  • История изменений

Массовые выплаты

  • Возможности
  • Как всё работает
  • Сценарии выплат
  • Возвраты выплат
  • Самозанятые

    • Выплаты самозанятым
    • Фискализация без выплаты

    Способы получения выплат

    • На российскую банковскую карту
    • На счет в российском банке
    • В кошелек QIWI
    • В кошелек ЮMoney (Яндекс.Деньги)
    • В налоговую
    • Через СБП по номеру телефона

    Выплаты по шагам

    • Выплата на карту с виджетом
    • Выплата с номинального счета
    • Выплата одним запросом
    • Выплата на карту с PCI DSS
    • Выплата самозанятому с фискализацией

Прием платежей

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Платежи через СБП по QR-коду
  • Платежи через Телеграм

    • Как создать платежного бота
    • Как подключить платежного бота
    • Как настроить платежного бота

    Сплит-платежи

    • Варианты и возможности
    • Сплит-платежи без доработок
    • Сплит-платежи по API

    Платежи по шагам

    • Оплата через платежную форму
    • Оплата с PCI DSS
    • Платеж одним запросом

Виджеты

  • Виджет для токенизации карты
  • Виджет платежной формы
  • Виджет для привязки самозанятого

Проверка паспорта

  • Возможности
  • Взаимодействие
  • Методы

    • Проверка паспорта
    • Статус проверки
  • Ответы и ошибки

Самозанятые

  • Общая информация
  • Привязка
  • Проверка привязки
  • Проверка данных
  • Оповещения из ФНС
  • Начисления и бонусы

Акты и реестры

  • Реестр выплат
  • Реестр платежей
  • Акт

Справочник API

  • Объекты
  • Методы
  • Вебхуки
  • Коды ошибок

Фискализация без выплаты

Вы можете провести фискализацию отдельно от выплаты — то есть зарегистрировать выплату самозанятому в налоговой и получить чек.

Этот метод доступен по запросу. Подробности можно узнать у менеджера в Банке 131.

Если чек выдали по ошибке, фискализацию можно отменить.

Как провести фискализацию

Шаг 1. Создайте платежную сессию

Отправьте запрос session/create и получите идентификатор session_id. Тело запроса — пустое.

Пример запроса на создание сессии

cURL
PHP
curl -X POST \
https://demo.bank131.ru/api/v1/session/create \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: 721af394d5a7aefd0e91f5390abc4d7e20fb2b5784b091fef621f3c61b7abb4b' \
-d '{}'
use Bank131\SDK\API\Request\Builder\RequestBuilderFactory;
use Bank131\SDK\Client;
use Bank131\SDK\Config;

$config = new Config(
'https://demo.bank131.ru',
'your_project_name',
file_get_contents('/path/to/your/private_key.pem')
);

$client = new Client($config);

$request = RequestBuilderFactory::create()
->createPayoutSession()
->build();

$response = $client->session()->create($request);

Шаг 2. Отправьте запрос на фискализацию

Создайте запрос с помощью метода fiscalization.

В параметре session_id передайте идентификатор сессии, созданной на предыдущем шаге.

В объекте ProfessionalIncomeTaxpayer передайте:

  • в поле payer_type значение legal (если выплату отправляет российская компания);
  • в поле payer_tax_number— ИНН компании, которая отправляет выплату (нужен, если payer_type: legal);
  • в поле tax_reference — ИНН самозанятого;
  • в services — данные для формирования чека.

Пример запроса на фискализацию

cURL
curl --location --request POST 'https://demo.bank131.ru/api/v1/fiscalization' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: project' \
--data-raw '{
"session_id": "ps_2704",
"fiscalization_details": {
"professional_income_taxpayer": {
"tax_reference": "123456789012",
"payer_type": "legal",
"payer_tax_number": "3316004777",
"payer_name": "ООО Рога и Копыта",
"services": [
{
"name": "Доставка товара",
"amount_details": {
"amount": 5000,
"currency": "rub"
}
},
{
"name": "Доставка сырья",
"amount_details": {
"amount": 5000,
"currency": "rub"
}
}
]
}
}
}'

Пример успешного ответа

{
    "status": "ok",
    "session": {
        "id": "ps_2704",
        "status": "in_progress",
        "created_at": "2021-05-27T08:13:33.736384Z",
        "updated_at": "2021-05-27T08:13:33.871729Z",
        "payments": [
            {
                "id": "po_2705",
                "status": "in_progress",
                "created_at": "2021-05-27T08:13:33.860754Z",
                "amount_details": {
                    "amount": 15000,
                    "currency": "rub"
                },
                "amounts": {
                    "gross": {
                        "amount": 15000,
                        "currency": "rub"
                    }
                },
                "fiscalization_details": {
                    "professional_income_taxpayer": {
                        "services": [
                            {
                                "name": "Доставка товара",
                                "amount_details": {
                                    "amount": 5000,
                                    "currency": "rub"
                                },
                                "quantity": 2
                            },
                            {
                                "name": "Доставка сырья",
                                "amount_details": {
                                    "amount": 5000,
                                    "currency": "rub"
                                },
                                "quantity": 1
                            }
                        ],
                        "tax_reference": "123456789012",
                        "payer_type": "legal",
                        "payer_tax_number": "3316004777",
                        "payer_name": "ООО Рога и Копыта"
                    }
                }
            }
        ]
    }
}

Шаг 3. Дождитесь уведомления о результате

Банк 131 отправит вам вебхук payment_finished. В теле вебхука придут все данные, которые вы отправили в запросе, и ссылка на чек из налоговой — в параметре fiscalization_details.receipt.

Пример вебхука payment_finished со ссылкой на чек

cURL
{
"type": "payment_finished",
"session": {
"id": "ps_2704",
"status": "accepted",
"created_at": "2021-06-08T09:07:34.689353Z",
"updated_at": "2021-06-08T09:07:53.491653Z",
"payments": [
{
"id": "po_23695",
"status": "succeeded",
"created_at": "2021-06-08T09:07:42.591416Z",
"finished_at": "2021-06-08T09:07:53.319963Z",
"amount_details": {
"amount": 15000,
"currency": "rub"
},
"amounts": {
"net": {
"amount": 15000,
"currency": "rub"
},
"gross": {
"amount": 15000,
"currency": "rub"
}
},
"fiscalization_details": {
"professional_income_taxpayer": {
"services": [
{
"name": "Доставка товара",
"amount_details": {
"amount": 5000,
"currency": "rub"
},
"quantity": 2
},
{
"name": "Доставка сырья",
"amount_details": {
"amount": 5000,
"currency": "rub"
},
"quantity": 1
}
],
"tax_reference": "645493572846",
"receipt": {
"id": "203zpt6nu5",
"link": "https://himself-ktr.nalog.ru/api/v1/receipt/645493572846/203zpt6nu5/print"
},
"payer_type": "legal",
"payer_tax_number": "3316004790",
"payer_name": "ООО Рога и Копыта"
}
}
}
]
}
}

 

Как отменить фискализацию

Иногда фискализацию нужно отменить, а выданный чек — аннулировать. Например, если выплата не прошла или чек выдали по ошибке.

Отправьте запрос на отмену фискализации

Создайте запрос session/refund. В поле session_id передайте идентификатор сессии из запроса на фискализацию, которую вы отменяете. В поле amount — полную сумму чека.

Пример запроса на отмену фискализации

cURL
curl -X POST \
https://demo.bank131.ru/api/v1/session/refund \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: 6eaf1e9cfa15f011e02c0a126187fe327a71e9d79be5e3fdb3f69dc5dfcd9871' \
-d '{
"session_id":"ps_2704"
}'

Дождитесь вебхука payment_refunded

Банк 131 пришлет вебхук payment_refunded со ссылкой на аннулированный чек.

При отмене фискализации Банк 131 передает в налоговую причину аннулирования «Чек сформирован ошибочно».

Пример вебхука

{
  "type": "payment_refunded",
  "session": {
    "id": "ps_2704",
    "status": "accepted",
    "created_at": "2021-06-08T09:07:34.689353Z",
    "updated_at": "2021-06-08T09:16:48.624196Z",
    "payments": [
      {
        "id": "po_23695",
        "status": "succeeded",
        "created_at": "2021-06-08T09:07:42.591416Z",
        "finished_at": "2021-06-08T09:07:53.319963Z",
        "amount_details": {
          "amount": 15000,
          "currency": "rub"
        },
        "amounts": {
          "net": {
            "amount": 15000,
            "currency": "rub"
          },
          "gross": {
            "amount": 15000,
            "currency": "rub"
          }
        },
        "fiscalization_details": {
          "professional_income_taxpayer": {
            "services": [
              {
                "name": "Доставка товара",
                "amount_details": {
                  "amount": 5000,
                  "currency": "rub"
                },
                "quantity": 2
              },
              {
                "name": "Доставка сырья",
                "amount_details": {
                  "amount": 5000,
                  "currency": "rub"
                },
                "quantity": 1
              }
            ],
            "tax_reference": "645493572846",
            "receipt": {
              "id": "203zpt6nu5",
              "link": "https://himself-ktr.nalog.ru/api/v1/receipt/645493572846/203zpt6nu5/print"
            },
            "payer_type": "legal",
            "payer_tax_number": "3316004790",
            "payer_name": "ООО Рога и Копыта"
          }
        },
        "refunds": [
          {
            "id": "rf_249",
            "status": "accepted",
            "created_at": "2021-06-08T09:16:42.897606Z",
            "finished_at": "2021-06-08T09:16:48.517040Z",
            "amount_details": {
              "amount": 15000,
              "currency": "rub"
            }
          }
        ]
      }
    ]
  }
}
← Выплаты самозанятымНа российскую банковскую карту →
  • Как провести фискализацию
    • Шаг 1. Создайте платежную сессию
    • Шаг 2. Отправьте запрос на фискализацию
    • Шаг 3. Дождитесь уведомления о результате
  • Как отменить фискализацию
    • Отправьте запрос на отмену фискализации
    • Дождитесь вебхука payment_refunded
Documentation
Документация
Массовые выплатыПрием платежейСправочник APIЮридические документы
Сценарии по шагам
Выплата на карту с токеномВыплата на карту с PCI DSSВыплата самозанятомуОплата через платежную форму
Напишите нам
Предложения и идеи — partners@131.ruПресса — press@131.ru
© 2022 Банк 131