Ir a contenido
Crea una cuenta
o
Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuenta
Iniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Herramientas para desarrolladores
ResumenConoce todos los productos
Empieza a desarrollar
Empezar a desarrollar
Proyectos de muestra
Acerca de las API
    Visita a las API
    API Payment Intents
      Cómo funciona PaymentIntents
      Actualizaciones del estado del pago
      Captura asíncrona
      Comparar con cargos
    API Setup Intents
    Métodos de pago
    Productos y precios
    API anteriores
    Fases de lanzamiento
Desarrolla con LLM
Utiliza Stripe sin necesidad de programación
Configura Stripe
Crea una cuenta.
Dashboard web
Dashboard móvil
Migra a Stripe
Gestiona el riesgo de fraude
Comprender el fraude
Protección contra fraudes de Radar
Gestionar disputas
Verificar identidades
InicioEmpieza ahoraAbout the APIsPayment Intents API

Cómo funciona PaymentIntents

Descubre cómo funcionan los PaymentIntents dentro del flujo de pago.

Copiar página

Los pagos que involucran procesos asincrónicos pueden ser complejos de administrar. Por ejemplo, es posible que se le solicite a un usuario que confirme un pago usando 3D Secure. Los flujos de pago asincrónicos son difíciles de gestionar porque dependen de las interacciones del cliente que suceden fuera de tu aplicación. PaymentIntents y SetupIntents simplifican la gestión mediante el seguimiento del estado del flujo en una state machine.

requires_payment_method

Cuando se crea el PaymentIntent, el estado es requires_payment_method1 hasta que se asocie un método de pago.

Te recomendamos crear el PaymentIntent en cuanto sepas cuánto quieres cobrar, así Stripe puede registrar todos los intentos de pago.

requires_confirmation
Optional

Después de que el cliente proporciona la información de pago, el PaymentIntent está listo para ser confirmado.

En la mayoría de las integraciones, se omite este estado porque la información del método de pago se envía al mismo tiempo que se confirma el pago.

requires_action

Si el pago requiere más acciones, como la autenticación con 3D Secure, el estado del PaymentIntent es requires_action1.

procesando

Una vez cumplidas las acciones requeridas, el PaymentIntent cambia a processing para los métodos de pago asincrónicos, como los débitos bancarios. El procesamiento de estos métodos puede demorar varios días. Otros métodos de pago, como las tarjetas, se procesan con mayor rapidez y no entran en estadoprocessing.

Si autorizas y capturas fondos por separado, tu PaymentIntent puede cambiar a requires_capture. En ese caso, si se intenta capturar los fondos, el estado pasa a processing.

succeeded

Si el estado de un PaymentIntent indica que se ha efectuado con éxito, implica que el flujo de pago ha finalizado.

Los fondos ya están en tu cuenta y puedes completar el pedido con confianza. Si necesitas hacerle un rembolso al cliente, puedes utilizar la API Refunds.

requires_payment_method

Si el intento de pago falla (por ejemplo debido a un rechazo), el estado del PaymentIntent vuelve a requires_payment_method para que se pueda volver a intentar el pago.

cancelado

Puedes cancelar un PaymentIntent en cualquier momento antes de que el estado pase a ser processing2 o succeeded. Cancelarlo invalida el PaymentIntent para futuros intentos de pago y esta acción no se puede deshacer. Si se retuvieron fondos, la cancelación los liberará.

También es posible que los PaymentIntents pasen automáticamente al estado canceled después de haberse confirmado demasiadas veces.

1 Las versiones del API anteriores a 2019-02-11 muestran requires_source en lugar de requires_payment_method y requires_source_action en lugar de requires_action.

2 Puedes cancelar un PaymentIntent con el estado processing cuando el Método de pago asociado es una Cuenta bancaria de EE. UU. Sin embargo, es posible que falle debido a un período de cancelación limitado y variable.

¿Te fue útil esta página?
SíNo
¿Necesitas ayuda? Ponte en contacto con soporte.
Únete a nuestro programa de acceso anticipado.
Echa un vistazo a nuestro registro de cambios.
¿Tienes alguna pregunta? Contacto.
¿LLM? Lee llms.txt.
Con tecnología de Markdoc