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.
Conceptos
Componentes de checkout
Flujo de pago, lado a lado
- Stripe Elements
- Yuno (Lite SDK / Secure Fields)
- Yuno (Seamless SDK)
- El servidor crea un PaymentIntent y devuelve
client_secret. - El navegador monta el Payment Element con el secreto.
- El navegador llama a
stripe.confirmPayment. - Stripe redirige o resuelve; tu servidor escucha
payment_intent.succeeded.
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.