Перейти к основному содержимому

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

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

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

Чтобы воспользоваться этой функциональностью, обратитесь к персональному менеджеру Банка 131.

Провести фискализацию​

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

Отправьте запрос на создание платежной сессии session/create. В ответе вы получите идентификатор сессии. Оставьте тело запроса пустым.

Пример создания платежной сессии
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: signature' \
  -d '{
  }'

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

Выполните запрос fiscalization, передав идентификатор сессии и данные для фискализации.

Пример запроса на фискализацию
curl -X POST \
  https://demo.bank131.ru/api/v1/fiscalization \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "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": "2025-05-27T08:13:33.736384Z",
    "updated_at": "2025-05-27T08:13:33.871729Z",
    "payments": [{
      "id": "po_2705",
      "status": "in_progress",
      "created_at": "2025-05-27T08:13:33.860754Z",
      "amount_details": {
        "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. Информация о результате выплаты содержится в параметре status объекта payments/payout_list. Статус succeeded означает, что фискализация прошла успешно. Ссылка на чек из ФНС возвращается в объекте fiscalization_details.receipt.

Пример вебхука о результате фискализации
curl -X POST \
  https://partner.ru \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "payment_finished",
    "session": {
      "id": "ps_2704",
      "status": "accepted",
      "created_at": "2025-06-08T09:07:34.689353Z",
      "updated_at": "2025-06-08T09:07:53.491653Z",
      "payments": [{
        "id": "po_2705",
        "status": "succeeded",
        "created_at": "2025-06-08T09:07:42.591416Z",
        "finished_at": "2025-06-08T09:07:53.319963Z",
        "amount_details": {
          "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",
            "receipt": {
              "id": "203zpt6nu5",
              "link": "https://himself-ktr.nalog.ru/api/v1/receipt/645493572846/203zpt6nu5/print"
            },
            "payer_type": "legal",
            "payer_tax_number": "3316004777",
            "payer_name": "ООО Вектор"
          }
        }
      }]
    }
  }'

Отменить фискализацию​

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

Шаг 1. Отправьте запрос на отмену фискализации​

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

Пример запроса на отмену фискализации
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: signature' \
  -d '{
    "session_id":  "ps_2704",
    "amount_details": {
      "amount": 15000,
      "currency": "rub"
    }
  }'

Шаг 2. Дождитесь вебхука о результате отмены​

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

к сведению

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

Пример вебхука о результате отмены
curl - X POST \
  https: //partner.ru \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "payment_refunded",
    "session": {
      "id": "ps_2704",
      "status": "accepted",
      "created_at": "2025-06-08T09:07:34.689353Z",
      "updated_at": "2025-06-08T09:16:48.624196Z",
      "payments": [{
        "id": "po_2705",
        "status": "succeeded",
        "created_at": "2025-06-08T09:07:42.591416Z",
        "finished_at": "2025-06-08T09:07:53.319963Z",
        "amount_details": {
          "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",
            "receipt": {
              "id": "203zpt6nu5",
              "link": "https://himself-ktr.nalog.ru/api/v1/receipt/645493572846/203zpt6nu5/print"
            },
            "payer_type": "legal",
            "payer_tax_number": "3316004777",
            "payer_name": "ООО Вектор"
          }
        },
        "refunds": [{
          "id": "rf_249",
          "status": "accepted",
          "created_at": "2025-06-08T09:16:42.897606Z",
          "finished_at": "2025-06-08T09:16:48.517040Z",
          "amount_details": {
            "amount": 15000,
            "currency": "rub"
          }
        }]
      }]
    }
  }'




ИИ-помощник