Выплаты одним запросом

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

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

Шаг 1. Создайте сессию одновременно с выплатой

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

Пример создания платежной сессии с выплатой

cURL

curl -X POST \
  https://demo.bank131.ru/api/v1/session/init/payout \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "payment_method": {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "2200********4940"
        }
      }
    },
    "participant_details": {
      "recipient": {
        "full_name": "Иванов Иван Иванович"
      }
    },
    "amount_details": {
      "amount": 10000,
      "currency": "rub"
    },
    "metadata": "good"
  }'

PHP

use Bank131\SDK\API\Request\Builder\RequestBuilderFactory;
use Bank131\SDK\Client;
use Bank131\SDK\Config;
use Bank131\SDK\DTO\Card\BankCard;
use Bank131\SDK\DTO\Participant;

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

$client = new Client($config);

$participant = new Participant();
$participant->setFullName('Иванов Иван Иванович');

$request = RequestBuilderFactory::create()
    ->initPayoutSession()
    ->setCard(new BankCard('2200********4940'))
    ->setRecipient($participant)
    ->setAmount(10000, 'rub')
    ->setMetadata('good')
    ->build();

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

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

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

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

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

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

Пример вебхука с результатом выплаты

cURL

curl -X POST \
  https://partner.ru \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "payment_finished",
    "session": {
      "id": "ps_3230",
      "status": "accepted",
      "created_at": "2025-05-27T02:03:00.000000Z",
      "updated_at": "2025-05-27T02:03:00.000000Z",
      "payments": [{
        "id": "po_2025",
        "status": "succeeded",
        "created_at": "2025-05-27T02:03:00.000000Z",
        "payment_method": {
          "type": "card",
          "card": {
            "last4": "4940",
            "brand": "mir",
            "bin": "220024",
            "country_iso3": "RUS"
          }
        },
        "participant_details": {
          "recipient": {
            "full_name": "Иванов Иван Иванович"
          }
        },
        "amount_details": {
          "amount": 10000,
          "currency": "rub"
        },
        "metadata": "good"
      }]
    }
  }'

PHP

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
}