Saltar al contenido principal
Headless era un cliente de tokenización pura: el comercio recopilaba los datos de la tarjeta en su propia interfaz, llamaba a apiClient.generateToken(collectedData, context), recibía un token y luego hacía su propia llamada al backend para crear el pago (y, cuando el backend devolvía un estado que requería 3DS, continuaba el pago mediante apiClient.continueCardPayment(…)). En la API unificada, el mismo escenario corresponde al modo headless no seamless: pasa los datos recopilados previamente dentro de transactionData en el PaymentMethodSelected, sobrescribe createPayment para crear el pago desde tu backend, y deja que el SDK orqueste automáticamente la tokenización, 3DS y la consulta del estado. El comercio ya no tiene que llamar a un endpoint 3DS aparte.

Uso de la lista de métodos de pago con Headless

Headless no significa que no puedas usar los componentes del SDK. Puedes combinar getPaymentMethodsViews para la selección del método con un start() headless para la ejecución del pago.
  • División de responsabilidades:
    • Yuno se encarga de: mostrar la lista de métodos de pago, mostrar los métodos de pago guardados del cliente, los botones de billeteras express (Google Pay), los desafíos 3DS, las redirecciones y los traspasos.
    • El comercio se encarga de: mostrar los campos personalizados para recopilar la tarjeta y tu propio botón de pago.
La vista Unfolded display no se puede usar con la recopilación headless de tarjetas. Cuando Unfolded display está habilitado en Checkout Builder → Styling, al seleccionar un método se incrusta y envía el formulario prediseñado de Yuno directamente dentro de la fila de la lista. Para recopilar los datos de la tarjeta en tus propios campos, asegúrate de que Unfolded display esté deshabilitado, de modo que la lista actúe estrictamente como selector.

Antes de empezar

  • Reemplaza los imports com.yuno.sdk.* por sus equivalentes com.yuno.payments.sdk.api.* (la comparación lado a lado los enumera). Tu clave de API pública y las sesiones de checkout que crea tu backend no cambian (Antes de comenzar).
  • Decide quién crea el pago. El workflow de la sesión de checkout debe coincidir con esa decisión:
Una sesión con el workflow predeterminado y sin sobrescritura de createPayment termina en INTERNAL_ERROR: el backend rechaza la creación del pago por parte del SDK. Consulta createPayment.

Comparación lado a lado

Qué cambia

Agrupado en el orden en que editas el código. Renombrado: mismo rol, nuevo nombre. Movido: mismo valor, nuevo propietario. Eliminado: no hay nada que llamar. Nuevo: sin equivalente anterior. La última columna es lo único que tienes que hacer además del cambio de nombre.

Inicialización y configuración

Controlador

Puntos de entrada