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

Платежи банковской картой

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

Этот способ подходит для сервисов, которые соответствуют стандарту PCI DSS и хранят данные карт самостоятельно.

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

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

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

Пример создания платежной сессии
curl -X POST \
  https://demo.bank131.ru/api/v1/session/create \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "customer": {
      "reference": "user123",
      "contacts": [{
        "email": "user@gmail.com"
      }]
    },
    "amount_details": {
      "amount": 10000,
      "currency": "rub"
    },
    "metadata": "good"
  }'

Шаг 2. Начните платеж​

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

Пример платежа
curl -X POST \
  https://demo.bank131.ru/api/v1/session/start/payment \
  -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": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "2200774546102058",
          "expiration_month": "01",
          "expiration_year": "26",
          "security_code": "123"
        }
      }
    },
    "customer": {
      "reference": "user123",
      "contacts": [{
        "email": "user@gmail.com"
      }]
    },
    "metadata": "good"
  }'

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

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

Пример вебхука о готовности платежа
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": "2018-05-27T02:03:00.000000Z",
      "updated_at": "2018-05-27T02:03:00.000000Z",
      "acquiring_payments": [{
        "id": "pm_2018",
        "status": "pending",
        "created_at": "2018-05-27T02:03:00.000000Z",
        "customer": {
          "reference": "user123",
          "contacts": [{
            "email": "user@gmail.com"
          }]
        },
        "payment_details": {
          "type": "card",
          "card": {
            "last4": "2058",
            "brand": "visa"
          }
        },
        "amount_details": {
          "amount": 10000,
          "currency": "rub"
        },
        "metadata": "good"
      }]
    }
  }'

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

Проверьте данные и подтвердите (session/confirm) или отмените (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"
  }'
Пример с отменой платежа
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"
  }'

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

Вебхук action_required приходит, если банк плательщика запрашивает прохождение 3D Secure.

Перенаправьте плательщика по ссылке из параметра customer_interaction.redirect.url для прохождения аутентификации 3D Secure.

Пример вебхука о дополнительных действиях
curl -X POST \
  https://partner.ru \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "action_required",
    "session": {
      "id": "ps_3230",
      "status": "in_progress",
      "created_at": "2018-05-27T02:03:00.000000Z",
      "updated_at": "2018-05-27T02:03:00.000000Z",
      "acquiring_payments": [{
        "id": "pm_131",
        "status": "pending",
        "created_at": "2018-05-27T02:03:00.000000Z",
        "customer": {
          "reference": "user123",
          "contacts": [{
            "email": "user@gmail.com"
          }]
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "2058"
          }
        },
        "amount_details": {
          "amount": 10000,
          "currency": "rub"
        },
        "customer_interaction": {
          "type": "redirect",
          "redirect": {
            "url": "https://bank131.ru?foo=bar",
            "base_url": "https://bank131.ru",
            "method": "POST",
            "qs": {
              "foo": "bar"
            },
            "params": {
              "paReq": "sdfew^//asdhbv",
              "MD": "abc75daefnn"
            }
          }
        }
      }]
    }
  }'
Пример обработки вебхука с помощью 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::ACTION_REQUIRED) {
    $session = $hook->getSession();
    //do your logic here
}

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

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

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

Схема платежа​

Схема платежа с PCI DSS

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

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