Introducción

Un objeto setup_intent representa una intención de inscripción de un método de pago por parte de un cliente.

El objeto setup_intent

Atributos


id string

Identificador único del objeto.


object string

Indica el tipo de objeto. Valor siempre será setup_intent.


customer_id string

ID objeto customer relacionado.


live boolean

Indica si el objeto existe en modo live o modo test.


metadata object

Conjunto de pares llave-valor que puedes asociar a un objeto.

Esto puede resultar útil para almacenar información adicional sobre el objeto en un formato estructurado.


session_id string

ID objeto session relacionado.


status enum

El estado del objeto.

Posibles valoresDescripción
pendingEstado inicial del objeto. Significa que el cliente podrá registrar su tarjeta.
succeededLa tarjeta fue registrada satisfactoriamente.
canceledEl objeto fue cancelado y ya está no está disponible para registrar una tarjeta.
expiredEl objeto fue expirado dado que tiene un limite de tiempo para poder registrar la tarjeta.

url string

Una URL utilizada para redirigir al cliente para que este inscriba un método de pago.


valid_until string

Fecha de expiración del campo url en formato ISO 8601. En huso horario UTC.


created_at string

Fecha de creación del objeto en formato ISO 8601. En huso horario UTC.


update_at string

Fecha de actualización del objeto en formato ISO 8601. En huso horario UTC.