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

Выплаты по токену

Здесь описан сценарий, при котором данные передаются в токенизированном виде.

Токен можно получить:

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

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

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

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

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

Выполните запрос session/start/payout, передав идентификатор сессии, параметры выплаты, включая токен, который у вас есть.

к сведению

Вы можете проверить данные токена или счета с помощью метода token/info.

Пример выплаты с токенизированными данными
curl -X POST \
  https://demo.bank131.ru/api/v1/session/init/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -d '{
    "payment_method": {
      "type": "bank_account",
      "bank_account": {
        "system_type": "ru",
        "ru": {
          "token": "3f03ee2580046153bb0aa859558e7ada10d3835270fdb4c4b70961239d37f31d",
          "full_name": "Иванов Иван Иванович",
          "description": "Перевод средств"
        }
      }
    },
    "amount_details": {
      "amount": 10000,
      "currency": "rub"
    },
    "metadata": "good"
  }'
Пример ответа
{
  "status": "ok",
  "session": {
    "id": "ps_1694821",
    "status": "in_progress",
    "created_at": "2024-02-27T09:25:30.655107Z",
    "updated_at": "2024-02-27T09:25:30.753188Z",
    "payments": [{
      "id": "po_495275",
      "status": "in_progress",
      "created_at": "2024-02-27T09:25:30.763145Z",
      "payment_method": {
        "type": "bank_account",
        "bank_account": {
          "system_type": "ru",
          "ru": {
            "token": "3f03ee2580046153bb0aa859558e7ada10d3835270fdb4c4b70961239d37f31d",
            "full_name": "Иванов Иван Иванович",
            "description": "Перевод средств"
          }
        }
      },
      "metadata": "good",
      "amount_details": {
        "amount": 10000,
        "currency": "rub"
      }
    }]
  }
}

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

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

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

Проверьте данные и подтвердите (session/confirm) или отмените (session/cancel) выплату.

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

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

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

Как исправить ошибки >

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

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





ИИ-помощник