Saltar al contenido principal
Esta página documenta un SDK heredado. ¿Vas a iniciar una nueva integración? Usa el Yuno SDK. ¿Ya usas un SDK heredado? Sigue la guía de migración.El nuevo Yuno SDK (Web v2.x, iOS v3.x, Android v3.x, React Native v2.x) reemplaza los SDK Full, Lite, Seamless, Render, Headless y Secure Fields con una sola API en todas las plataformas. Los SDK heredados siguen siendo compatibles en paralelo durante la transición y está previsto dejarlos de usar en 2027. Contacta a tu Account Manager para planificar la migración.
Si tu checkout funciona hoy con Stripe Elements, pasar a Yuno cambia la capa de checkout, no tu cuenta de Stripe. Yuno se conecta a Stripe como uno más de los proveedores que habilitas, por lo que el procesamiento actual con Stripe sigue funcionando mientras agregas enrutamiento, otros proveedores y el checkout de Yuno. Esta página relaciona cada concepto de Stripe con lo que usas en Yuno.

Conceptos

Componentes de checkout

Flujo de pago, lado a lado

  1. El servidor crea un PaymentIntent y devuelve client_secret.
  2. El navegador monta el Payment Element con el secreto.
  3. El navegador llama a stripe.confirmPayment.
  4. Stripe redirige o resuelve; tu servidor escucha payment_intent.succeeded.
Una diferencia estructural en ambos caminos: tu clave privada nunca llega al navegador. La sesión de checkout se crea en tu servidor y, con Lite SDK y Secure Fields, el pago también se crea allí.

Webhooks

Yuno envía un tipo de evento por objeto y lleva el estado dentro del payload, por lo que varios eventos de Stripe se reúnen en un solo evento de Yuno. Consulta Webhooks y Configurar webhooks. Cada webhook de Yuno incluye data.idempotency_key y un encabezado x-hmac-signature; verifícalo como se describe en Verificar firmas de webhooks.

Tarjetas guardadas

Las tarjetas guardadas en Stripe se pueden llevar a Yuno para que los clientes recurrentes no tengan que volver a ingresarlas. Yuno admite una migración de tokens de proveedor a proveedor, cifrada con PGP, mediante el Proceso de migración de tokens. Las series recurrentes continúan sin una nueva autenticación porque Yuno almacena el ID de transacción de la red con cada vaulted token; consulta Credenciales almacenadas.

Orden de migración

1

Conecta Stripe en Yuno

Agrega tu cuenta de Stripe como una conexión y colócala en una ruta. Por ahora nada cambia para los compradores. Consulta Configurar una conexión de pago.
2

Reemplaza el checkout

Cambia el Payment Element por el Seamless SDK, o el Card Element por Lite SDK o Secure Fields, siguiendo React y Next.js. Ejecútalo primero con la misma conexión de Stripe para poder comparar las tasas de aprobación en igualdad de condiciones.
3

Mueve los webhooks

Suscribe tus controladores actuales a los eventos de Yuno de la tabla anterior y cambia la lógica de estados a los valores status y sub_status de Yuno.
4

Migra las tarjetas guardadas

Ejecuta la migración de tokens y cambia los cobros con tarjetas almacenadas a vaulted_token.
5

Agrega proveedores y enrutamiento

Cuando el tráfico sea estable, agrega otros proveedores y deja que Routing y Monitors decidan adónde va cada pago.