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.
onCardInfoChanged para recibir la marca, el tipo, la categoría, el emisor y el país de la tarjeta mientras el comprador escribe el número en el formulario de tarjeta. Recibes estos datos antes de que el comprador envíe el formulario, así que puedes adaptar tu checkout en tiempo real: mostrar la marca de la tarjeta o el banco emisor en el resumen del pedido, explicar una promoción que aplica solo a tarjetas de crédito o adaptar un mensaje al país del banco emisor.
El callback es informativo y opcional: si no lo registras, el comportamiento del SDK no cambia. El SDK ya consulta los datos de la tarjeta a partir del sexto dígito para mostrar la marca y cargar las cuotas, y el callback te entrega el resultado de esa misma consulta. No hace ninguna llamada de red adicional y nunca incluye el número completo de la tarjeta, el código de seguridad, la fecha de vencimiento ni el nombre del titular de la tarjeta.
El callback se ejecuta en cada formulario de tarjeta que el SDK muestra para una tarjeta nueva, tanto en pagos como en inscripciones. No se llama para tarjetas guardadas (inscritas), porque el comprador no escribe un número, ni en integraciones headless, porque el SDK no muestra ningún formulario de tarjeta en ellas.
Qué recibes
Un objeto de información de la tarjeta, onull (nil en iOS) como se describe en Cuándo se llama.
- Los valores se pasan exactamente como los devuelve la consulta de la tarjeta. El SDK no los traduce ni los normaliza.
- Un valor que la consulta no devuelve es
null(nilen iOS). Algunos campos, comoissuerCode, suelen estar vacíos, así que no los hagas obligatorios en tu lógica. - En iOS,
iinsiempre está presente. Todos los demás campos son opcionales en ambas plataformas. - La longitud de
iinvaría entre 6 y 8 dígitos. No dependas de ella. - Cada valor también está disponible por clave:
rawDataen iOS ytoMap()en Android siempre devuelven las nueve claves anteriores, con los mismos nombres en ambas plataformas. En iOS, un valor faltante enrawDataesNSNull.
Cuándo se llama
- Después de que la consulta de la tarjeta responde, una vez que el comprador ha escrito al menos 6 dígitos.
- De nuevo solo cuando el resultado cambia. Escribir más dígitos de la misma tarjeta no lo vuelve a llamar, a menos que la consulta devuelva datos distintos. En iOS, también puede llegar una nueva llamada cuando la consulta coincide con un prefijo más largo de la misma tarjeta, con solo
iinmodificado. - Con
null(nilen iOS) cuando una tarjeta que ya recibiste deja de aplicar: el número baja de 6 dígitos, se borra el campo o falla la consulta. La primera llamada nunca esnull. - En el hilo principal, así que puedes actualizar tu interfaz directamente.
Implementación
- iOS
- Android
Implementa el método opcional El método recibe un payload Para leer los valores por clave, usa Para Seamless, configura En Objective-C:
onCardInfoChanged(_:) en el delegado que pasas al SDK: YunoPaymentDelegate para pagos (Full, Lite y Render) y YunoEnrollmentDelegate para inscripciones. El método es el mismo en ambos.YunoCardInfo?, también disponible desde Objective-C:rawData:SeamlessParams.onCardInfoChanged en su lugar, porque Seamless no recibe un delegado. Define el closure antes de llamar a startPaymentSeamlessLite: se lee una sola vez, cuando comienza el pago.Mejores prácticas
- Mantén el controlador liviano. Se ejecuta en el hilo principal mientras el comprador escribe, así que mueve fuera del hilo principal cualquier trabajo lento, como una llamada a tu backend.
- Maneja
null(nilen iOS): borra u oculta lo que mostraste para la tarjeta anterior. - Trata cada llamada como el estado actual del formulario, no como un valor final. El comprador todavía puede cambiar el número antes de pagar.
- No bloquees ni retrases el pago según estos valores. El SDK valida la tarjeta por su cuenta.
Pruebas
- En sandbox, abre un formulario de tarjeta desde tu app con el callback registrado.
- Escribe el número de una tarjeta de prueba. Después del sexto dígito recibes los datos de la tarjeta.
- Borra dígitos hasta que queden menos de 6. Recibes
null(nilen iOS). - Escribe el número de una tarjeta de otra marca. Recibes los nuevos datos.
- Paga con una tarjeta guardada. El callback no se llama.
Relacionado
- Cuotas. Un callback similar para la opción de cuotas que elige el comprador.
onCardInfoChangeden el Yuno SDK. La misma información en el Yuno SDK (iOS y Android v3.x).