Saltar al contenido principal
Headless era un cliente de tokenización pura: el comercio recopilaba los datos de la tarjeta en su propia interfaz, generaba un token y hacía su propia llamada al backend para crear el pago. En la API unificada el mismo escenario es un start() headless. Pasa los datos recopilados previamente dentro de data en el paymentMethod que entregas a start(), sobrescribe createPayment para hacer POST a tu backend (modo manual), y deja que el SDK orqueste automáticamente la tokenización, 3DS y la consulta del estado. Si no quieres que el SDK continúe el flujo después de crear el pago, define autoContinuePayment como false en el objeto TransactionConfig.

Usar 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 exprés (Apple Pay, Google Pay, PayPal), 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 Pay.
La visualización desplegada no se puede usar con la recopilación de tarjeta headless. 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 para que la lista actúe estrictamente como un selector.

Antes de empezar

  • Carga el bundle del SDK unificado en lugar del heredado e inicialízalo como muestra la comparación lado a lado: window.Yuno.initialize(...) pasa a ser SdkPayments.initialize(...). 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 la 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 dueño. Eliminado: nada que llamar. Nuevo: sin equivalente heredado. La última columna es lo único que tienes que hacer además del cambio de nombre.

Inicialización y configuración

Callbacks

Puntos de entrada