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

Выплаты с номинального счета на банковские счета

Вы можете делать выплаты с номинального счета на банковские счета следующими способами:

В этой инструкции описан сценарий выплаты по номеру счета. Перед началом выплаты идентифицируйте бенефициара.

Как подключить вебхук для отслеживания пополнений номинального счета >

Счета для выплат​

Выплаты можно отправлять только на банковские счета, которые начинаются с этих цифр:

  • 40817810
  • 42301810
  • 42302810
  • 42303810
  • 42304810
  • 42305810
  • 42306810
  • 42307810
  • 40802810
  • 40701810
  • 40502810
  • 40702810 (для юридических лиц)

Требования к назначению выплаты​

При переводе денег в параметре bank_account.ru.description необходимо указать следующие данные:

  • тип операции (например, оплата услуг);
  • основание выплаты (например, по договору № 123);
  • наименование работ, услуг, товаров;
  • облагается НДС или нет.

Если организация или физическое лицо не являются резидентами РФ, в назначении выплаты нужно указать код валютной операции в формате: {VO<код вида валютной операции>}, предварительно согласованный с Банком 131.

Важно!

Запрещены символы: ?, !.

Максимальная длина текста: 210 символов.

Пример назначения выплаты​

Перевод средств по договору № 5015553456 Иванов Иван Иванович НДС не облагается

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

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

Вы можете создать сессию и выплату одновременно (session/init/payout/nominal). В этом случае сразу передайте параметры выплаты с открытыми данными и пропустите следующий шаг. Не рекомендуем использовать этот способ.

Пример создания платежной сессии
curl -X POST \
  https://demo.bank131.ru/api/v1/session/create/nominal \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "metadata": "good"
  }'

Шаг 2. Отправьте выплату​

Выполните запрос session/start/payout/nominal, передав идентификатор сессии и параметры выплаты с открытыми данными.

Пример выплаты с открытыми данными
curl -X POST \
  https:// api/v1/session/start/payout/nominal \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_2643",
    "payment_method": {
      "type": "bank_account",
      "bank_account": {
        "ru": {
          "bik": "044525974",
          "account": "40817810400003869535",
          "full_name": "Иванов Иван Иванович",
          "description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
        },
        "system_type": "ru"
      }
    },
    "amount_details": {
      "amount": 300000,
      "currency": "rub"
    },
    "participant_details": {
      "sender": {
        "account": "40702810300200000013"
      },
      "recipient": {
        "beneficiary_id": "1234567890"
      }
    }
  }'

Шаг 3. Дождитесь вебхука о готовности выплаты​

Банк 131 отправит вам вебхук ready_to_confirm о готовности провести выплату и ожидании вашего подтверждения или отмены.

В теле вебхука найдите объект confirm_information и сохраните его — эти данные нужно будет передать для подтверждения выплаты.

Пример вебхука о готовности выплаты
curl -X POST \
  https://partner.ru \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "ready_to_confirm",
    "session": {
      "id": "ps_2643",
      "status": "in_progress",
      "created_at": "2025-02-20T08:42:35.905869Z",
      "updated_at": "2025-02-20T08:42:36.382627Z",
      "payments": [{
        "id": "po_513",
        "status": "pending",
        "created_at": "2025-02-20T08:42:35.965210Z",
        "payment_method": {
          "type": "bank_account",
          "bank_account": {
            "system_type": "ru",
            "ru": {
              "bik": "044525974",
              "account": "40702810500000000001",
              "full_name": "ООО Вектор",
              "description": "Перечисление денежных средств по договору за декабрь 2025 г. НДС не облагается.",
              "is_fast": false,
              "kpp": "156605101",
              "inn": "1111111111"
            }
          }
        },
        "amount_details": {
          "amount": 300000,
          "currency": "RUB"
        },
        "paymentMetadata": {},
        "participant_details": {
          "sender": {
            "account": "40702810300200000013"
          }
        },
        "payment_options": {
          "recurrent": false,
          "is_subsequent": false
        }
      }],
      "next_action": "confirm",
      "session_metadata": {}
    },
    "confirm_information": {
      "account_details": {
        "sender": {
          "account_number": "40702810300200000013",
          "name": "Наименование компании",
          "bank_name": "Наименование банка",
          "bik": "049205131",
          "correspondent_account_number": "30101810822029205131",
          "inn": "3316004790",
          "kpp": "156605101"
        },
        "recipient": {
          "account_number": "40702810500000000001",
          "name": "ООО Вектор",
          "bank_name": "Наименование банка",
          "bik": "044525974",
          "correspondent_account_number": "30101810822000000974",
          "inn": "1111111111",
          "kpp": "156605101"
        }
      }
    }
  }'

Шаг 4. Подтвердите или отмените выплату​

Проверьте данные и подтвердите выплату (session/confirm), передав объект confirm_information. Или отмените (session/cancel) выплату.

Пример с подтверждением выплаты
curl -X POST \
  https://demo.bank131.ru/api/v1/session/confirm \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_2643",
    "confirm_information": {
      "account_details": {
        "sender": {
          "account_number": "40702810300200000013",
          "name": "Наименование компании",
          "bank_name": "Наименование банка",
          "bik": "049205131",
          "correspondent_account_number": "30101810822029205131",
          "inn": "3316004790",
          "kpp": "156605101"
        },
        "recipient": {
          "account_number": "40702810500000000001",
          "name": "ООО Вектор",
          "bank_name": "Наименование банка",
          "bik": "044525974",
          "correspondent_account_number": "30101810822029205974",
          "inn": "1111111111",
          "kpp": "156605101"
        }
      }
    }
  }'
Пример с отменой выплаты
curl -X POST \
  https://demo.bank131.ru/api/v1/session/cancel \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_2643",
    "confirm_information": {
      "account_details": {
        "sender": {
          "account_number": "40702810300200000013",
          "name": "Наименование компании",
          "bank_name": "Наименование банка",
          "bik": "049205131",
          "correspondent_account_number": "30101810822029205131",
          "inn": "3316004790",
          "kpp": "156605101"
        },
        "recipient": {
          "account_number": "40702810500000000001",
          "name": "ООО Вектор",
          "bank_name": "Наименование банка",
          "bik": "044525974",
          "correspondent_account_number": "30101810822029205974",
          "inn": "1111111111",
          "kpp": "156605101"
        }
      }
    }
  }'

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

Банк 131 отправит вам вебхук payment_finished. Информация о результате выплаты содержится в параметре status объекта payments/payout_list.

Статус succeeded означает, что выплата прошла успешно. Если статус failed — выплата не прошла из-за ошибки.

Какие бывают статусы выплаты >

Посмотреть коды ошибок >

Как узнать, что выплата вернулась >





ИИ-помощник