Что такое статус requires_action
В API Stripe объект PaymentIntent проходит через несколько статусов в течение жизненного цикла платежа. Один из них — requires_action.
Этот статус означает, что Stripe уже создал намерение платежа и выбрал способ оплаты, но для завершения транзакции требуется действие со стороны покупателя. Платёж поставлен на паузу — он ждёт вас.
Почему это происходит
Статус requires_action возникает в нескольких ситуациях:
- 3DS-аутентификация. Самый частый случай. Банк запрашивает подтверждение через 3D Secure. Это может быть OTP-код, биометрия или подтверждение в мобильном приложении.
- Редирект на страницу банка. Для некоторых методов оплаты (банковский перевод, iDEAL, Bancontact) пользователь должен перейти на страницу своего банка.
- Другие действия. В редких случаях может потребоваться другой тип действия, определённый в поле
next_actionобъекта PaymentIntent.
Что нужно сделать покупателю
Действие зависит от типа next_action:
use_stripe_sdk/redirect_to_url— Stripe откроет всплывающее окно или перенаправит вас на страницу аутентификации банка. Следуйте инструкциям.OTP-код по SMS — проверьте телефон на наличие сообщения от банка. Введите код в открывшемся поле.
Push-уведомление — откройте мобильное приложение банка и подтвердите платёж.
Страница банка — если вас перенаправили на сайт банка, войдите в систему и одобрите транзакцию.
После успешного завершения действия статус PaymentIntent автоматически изменится на succeeded.
Технические детали для разработчиков
Если вы разработчик и интегрируете Stripe:
- Используйте
stripe.handleNextAction()(Stripe.js) для обработкиrequires_actionавтоматически. - Webhook-событие
payment_intent.requires_actionуведомит вас о том, что нужно показать пользователю форму подтверждения. - Не считайте
requires_actionошибкой — это нормальный шаг жизненного цикла платежа при SCA.
FAQ
Сколько времени действителен статус requires_action?
Обычно 15–30 минут. Если покупатель не выполнил действие за это время, сессия истекает и PaymentIntent переходит в статус requires_payment_method.
Что если я нажал «назад» во время аутентификации?
Статус PaymentIntent останется requires_action, но ссылка действия может стать неактивной. Мерчант должен либо показать кнопку «повторить», либо создать новый PaymentIntent.
Могу ли я получить requires_action при оплате через Apple Pay?
Обычно нет. Apple Pay использует Device Account Number и биометрию внутри устройства, что автоматически удовлетворяет требования SCA без дополнительных шагов.
Читайте также
- AML review pending — что значит и как долго ждать
- Аргентинский Xbox ещё работает в 2026 — честный ответ
- Как не попасть на скам при покупке цифровых кодов
- Биллинговый адрес и ZIP-код при онлайн-платежах — что вводить, если карта из другой страны
- Как браузерный фингерпринт влияет на оплату
Хотите минимизировать количество дополнительных шагов при оплате? Попробуйте Marix. Наши карты оптимизированы для международных платежей.