Transaction gestiona la inscripción. Solo cambia el tipo de sesión. En Web, la transacción de inscripción expone start(), secureFields() y unmount(). Los métodos exclusivos de pago (getPaymentMethodsViews, submit, updateCheckoutSession) y los campos de configuración exclusivos de pago no están disponibles.
El tipo de sesión es lo que selecciona el modo: si pasas
checkoutSession, se ejecuta un pago, y si pasas customerSession, se ejecuta una inscripción. Debes proporcionar exactamente una de las dos. En iOS la elección se hace en tiempo de compilación: TransactionConfig tiene un inicializador por cada tipo de sesión, por lo que no se puede escribir una configuración con ambas o con ninguna. En Android y Web, proporcionar ambas, o ninguna, falla al construir con un error de validación. En Android el mensaje es Exactly one of checkoutSession or customerSession must be provided. En Web el mensaje es Provide either checkoutSession or customerSession, not both. o A checkoutSession or customerSession is required. En React Native, new Transaction(config) lanza Exactly one of checkoutSession or customerSession must be provided. Consulta ¿Por dónde empiezo? para ver la guía de decisión completa.Antes de empezar
Tu backend debe crear los recursos necesarios para la inscripción:- Crea el cliente. Consulta
POST /v1/customers. - Crea la sesión de cliente. Consulta
POST /v1/customers/sessions. - Crea el método de pago. Consulta
POST /v1/customers/sessions/{customer_session}/payment-methods. Esta llamada requiere un encabezadoX-Idempotency-Key; sin él, la API devuelve400 INVALID_PARAMETERS.
Implementación
Pasa elcustomerSession (en lugar de checkoutSession) en TransactionConfig y llama a start(). En Android, pasa el método que el cliente eligió en paymentSelected, igual que haces con un pago. En iOS, start(paymentSelected:) recibe el mismo objeto, pero el método que se inscribe es el que tu backend creó en la sesión de cliente: el SDK lo lee de la sesión y no usa paymentMethodType para seleccionarlo. En Web, start() muestra el formulario del SDK para el método que tu backend inscribió en la sesión de cliente, y paymentMethod solo se necesita para una inscripción headless (consulta Omitir el formulario). En React Native, start(paymentSelected) se comporta como el SDK nativo de la plataforma. El SDK entrega el estado final a onStatus cuando la inscripción se completa.
Mostrar y seleccionar el método de pago que se va a inscribir es responsabilidad tuya. El SDK no presenta una lista de métodos inscribibles. Para obtener los métodos disponibles, llama a GET /v1/customers/sessions/{customer_session}/payment-methods. En iOS y Web, la elección llega al SDK a través de la sesión de cliente, con la llamada POST de Antes de empezar.
- Web
- iOS
- Android
- React Native
elementSelector es opcional en Web. Sin él, el SDK agrega su propio contenedor al final de <body> y muestra el formulario allí.Omitir el formulario
Si recopilas los datos del cliente en tu propia interfaz, pásalos mediantetransactionData (data en Web) en el PaymentMethodSelected. El SDK omitirá su formulario integrado y tokenizará directamente: un flujo headless, que ignora el elementSelector de la configuración de la transacción (solo se aplica a los flujos basados en formulario). Consulta TransactionData para ver la estructura completa de los datos.
vaultedToken en PaymentMethodSelected se ignora durante la inscripción. El propósito del flujo es producir un nuevo token almacenado, por lo que aún no hay nada vinculado a lo que hacer referencia.Notas
- Puede ocurrir un desafío 3DS durante la inscripción.
createPaymentno aplica porque no hay ningún pago que crear. En Web, la configuración de inscripción no lo acepta (TypeScript rechaza la propiedad). En iOS, Android y React Native no se invoca.- Cuando la inscripción es exitosa,
onStatusentrega el estado final, con la misma estructura de payload que los flujos de pago (status,substatus,message). El token almacenado no se expone al cliente: recupéralo desde el endpoint de listado de métodos de pago del cliente de tu backend después de que llegue el estado de éxito, y guárdalo asociado a tu cliente para usarlo en pagos futuros.
Relacionado
- Sesiones. Sesiones de checkout frente a sesiones de cliente.
TransactionConfig. Referencia completa.onStatus. Recibe el estado final.