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

Платежи одним запросом

Платежи банковскими картами можно проводить одним запросом — результат вернется сразу в ответе. Вебхуки от Банка 131 в этом случае не отправляются.

Данный способ подходит, если вы не используете виджет платежной формы.

Не рекомендуем проводить платежи одним запросом. Если все же хотите подключить этот способ, обратитесь к персональному менеджеру Банка 131.

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

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

Пример платежа одним запросом
curl -X POST \
  https://proxy.bank131.ru/api/v1/session/init/payment/sync \
  -H 'Content-Type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "payment_details": {
      "type": "card",
      "card": {
        "type": "bank_card",
        "bank_card": {
          "number": "4242424242424242",
          "expiration_month": "01",
          "expiration_year": "22",
          "security_code": "123"
        }
      }
    },
    "amount_details": {
      "amount": 10000,
      "currency": "rub"
    },
    "customer": {
      "reference": "lucky"
    },
    "payment_options": {
      "return_url": "https://131.ru"
    }
  }'

Шаг 2. Дождитесь результата платежа​

Статус платежа возвращается в ответе на запрос в параметре status массива acquiring_payments/payment_list:

  • succeeded — оплата прошла успешно;
  • failed — оплата не прошла из-за ошибки;
  • pending — требуется прохождение 3D Secure. Перенаправьте плательщика по ссылке из параметра customer_interaction.redirect.url для прохождения аутентификации 3D Secure;
  • in_progress — платеж обрабатывается (возвращается, если обработка занимает более 40 секунд).
Пример успешного ответа
{
  "status": "ok",
  "session": {
    "id": "ps_3230",
    "status": "accepted",
    "created_at": "2025-05-27T02:03:00.000000Z",
    "updated_at": "2025-05-27T02:03:00.000000Z",
    "acquiring_payments": [{
      "id": "pm_203",
      "status": "succeeded",
      "created_at": "2025-05-27T02:03:00.000000Z",
      "customer": {
        "reference": "lucky"
      },
      "payment_details": {
        "type": "card",
        "card": {
          "brand": "visa",
          "last4": "4242"
        }
      },
      "amount_details": {
        "amount": 10000,
        "currency": "rub"
      },
      "payment_options": {
        "return_url": "https://131.ru"
      }
    }]
  }
}
к сведению

Окончательный статус также можно проверить через запрос session/status.

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