Single-request payouts

You can send a payout by card number within a single request. The system automatically handles data transfer and confirms payments without any intermediate steps. In this case, you will need to comply with all the requirements of PCI DSS for this method.

To enable singe-request payouts, contact your account manager at Bank 131. Once this option is enabled, all your payouts will be processed this way. To disable it, contact your account manager again.

Step 1. Create a session along with a payout

Send a session/init/payout request, specifying the parameters for payouts with open data.

Request example

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": "Ivanov Ivan Ivanovich"
      }
    },
    "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('Ivanov Ivan Ivanovich');

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

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

Step 2. Wait for a webhook with the payout results

Bank 131 will send you a payment_finished webhook. The result of the payout can be found in the status field of the payments/payout_list object.

If the status is succeeded, then the payout was successful. If the status is failed, then an error occurred during the payout.

More about the payout statuses >

View error codes >

Webhook example

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": "2012505-27T02:03:00.000000Z",
        "payment_method": {
          "type": "card",
          "card": {
            "last4": "4940",
            "brand": "mir",
            "bin": "220024",
            "country_iso3": "RUS"
          }
        },
        "participant_details": {
          "recipient": {
            "full_name": "Ivanov Ivan Ivanovich"
          }
        },
        "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
}