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

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

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

В этой инструкции описан сценарий выплаты по номеру карты. Для этого способа нужно выполнять требования стандарта PCI DSS. Перед началом выплаты идентифицируйте бенефициара.

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

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

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

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

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

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

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

Пример выплаты с открытыми данными
curl -X POST \
  https://demo.bank131.ru/api/v1/session/multi/start/payment/nominal \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "session_id": "ps_3230",
    "payment_details": {
      "type": "internal_transfer",
      "internal_transfer": {
        "type": "transfer_from_nominal_account",
        "transfer_from_nominal_account": {
          "description": "Перевод согласно оферте"
        }
      }
    },
    "payment_method": {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "5536********8371"
        }
      }
    },
    "participant_details": {
      "sender": {
        "full_name": "Наименование компании",
        "beneficiary_id": "1234567890"
      },
      "recipient": {
        "full_name": "Иванов Иван Иванович"
      }
    },
    "amount_details": {
      "amount": 293400,
      "currency": "RUB"
    },
    "customer": {
      "reference": "123456789012"
    }
  }'

Шаг 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_3230",
      "status": "in_progress",
      "created_at": "2025-09-14T09:32:19.891392Z",
      "updated_at": "2025-09-14T09:32:20.494410Z",
      "payments": [{
        "id": "po_7639847",
        "status": "pending",
        "created_at": "2025-09-14T09:32:20.100149Z",
        "customer": {
          "reference": "123456789012"
        },
        "payment_method": {
          "type": "card",
          "card": {
            "brand": "mastercard",
            "last4": "8371",
            "country_iso3": "RUS"
          }
        },
        "amount_details": {
          "amount": 293400,
          "currency": "RUB"
        },
        "participant_details": {
          "sender": {
            "full_name": "Наименование компании",
            "beneficiary_id": "1234567890"
          },
          "recipient": {
            "full_name": "Иванов Иван Иванович"
          }
        }
      }],
      "acquiring_payments": [{
        "id": "pm_6933973",
        "status": "pending",
        "created_at": "2025-09-14T09:32:20.099952Z",
        "customer": {
          "reference": "123456789012"
        },
        "payment_details": {
          "type": "internal_transfer",
          "internal_transfer": {
            "type": "transfer_from_nominal_account",
            "transfer_from_nominal_account": {
              "description": "Перевод согласно оферте",
              "card_mask": "553691******8371"
            }
          }
        },
        "amount_details": {
          "amount": 293400,
          "currency": "RUB"
        },
        "participant_details": {
          "sender": {
            "full_name": "Наименование компании",
            "beneficiary_id": "1234567890"
          },
          "recipient": {
            "full_name": "Иванов Иван Иванович"
          }
        }
      }],
      "next_action": "confirm"
    },
    "confirm_information": {
      "transfer_details": {
        "payment_method": {
          "type": "card",
          "card": {
            "brand": "mastercard",
            "last4": "8371",
            "country_iso3": "RUS"
          }
        },
        "customer": {
          "account_number": "40702810700200000000",
          "name": "Наименование компании",
          "bank_name": "Наименование банка",
          "bik": "049205131",
          "correspondent_account_number": "30101810822000000000"
        },
        "recipient": {
          "account_number": "30233810000000000000",
          "name": "Иванов Иван Иванович",
          "bank_name": "Наименование банка",
          "bik": "049205123",
          "correspondent_account_number": "30101810822000000974"
        },
        "purpose": "Перевод согласно оферте",
        "amount": {
          "amount": 293400,
          "currency": "RUB"
        }
      }
    }
  }'

Шаг 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_3230",
    "confirm_information": {
      "transfer_details": {
        "payment_method": {
          "type": "card",
          "card": {
            "brand": "mastercard",
            "last4": "8371",
            "country_iso3": "RUS"
          }
        },
        "customer": {
          "account_number": "40702810700200000000",
          "name": "Наименование компании",
          "bank_name": "Наименование банка",
          "bik": "049205131",
          "correspondent_account_number": "30101810822000000000"
        },
        "recipient": {
          "account_number": "30233810000000000000",
          "name": "Иванов Иван Иванович",
          "bank_name": "Наименование банка",
          "bik": "049205123",
          "correspondent_account_number": "30101810822000000974"
        },
        "purpose": "Перевод согласно оферте",
        "amount": {
          "amount": 293400,
          "currency": "RUB"
        }
      }
    }
  }'
Пример с отменой выплаты
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_3230",
    "confirm_information": {
      "transfer_details": {
        "payment_method": {
          "type": "card",
          "card": {
            "brand": "mastercard",
            "last4": "8371",
            "country_iso3": "RUS"
          }
        },
        "customer": {
          "account_number": "40702810700200000000",
          "name": "Наименование компании",
          "bank_name": "Наименование банка",
          "bik": "049205131",
          "correspondent_account_number": "30101810822000000000"
        },
        "recipient": {
          "account_number": "30233810000000000000",
          "name": "Иванов Иван Иванович",
          "bank_name": "Наименование банка",
          "bik": "049205123",
          "correspondent_account_number": "30101810822000000974"
        },
        "purpose": "Перевод согласно оферте",
        "amount": {
          "amount": 293400,
          "currency": "RUB"
        }
      }
    }
  }'

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

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

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

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

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

Пример обработки вебхука с помощью SDK
use Bank131\SDK\Client;
use Bank131\SDK\Config;
use Bank131\SDK\Services\WebHook\Hook\WebHookTypeEnum;

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

$client = new Client($config);

$hook = $client->handleWebHook('sign from headers', 'request body');

if ($hook->getType() === WebHookTypeEnum::PAYMENT_FINISHED) {
    $session = $hook->getSession();
    //do your logic here
}




ИИ-помощник