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.
Registra el callback opcional 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, o null (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 (nil en iOS). Algunos campos, como issuerCode, suelen estar vacíos, así que no los hagas obligatorios en tu lógica.
  • En iOS, iin siempre está presente. Todos los demás campos son opcionales en ambas plataformas.
  • La longitud de iin varía entre 6 y 8 dígitos. No dependas de ella.
  • Cada valor también está disponible por clave: rawData en iOS y toMap() en Android siempre devuelven las nueve claves anteriores, con los mismos nombres en ambas plataformas. En iOS, un valor faltante en rawData es NSNull.

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 iin modificado.
  • Con null (nil en 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 es null.
  • En el hilo principal, así que puedes actualizar tu interfaz directamente.
Si el comprador sigue escribiendo o edita el número mientras una consulta está en curso, las respuestas desactualizadas se descartan, de modo que nunca recibes los datos de un número que el comprador ya cambió. No se envía nada cuando se cierra el formulario de tarjeta, cuando el comprador paga o cuando elige otro método de pago: prevalece el último valor que recibiste. Si tu interfaz necesita restablecerlo en esos casos, hazlo de tu lado. Cada formulario de tarjeta comienza desde cero. Si el comprador cierra el formulario y lo abre de nuevo, el primer resultado del nuevo formulario se entrega aunque sea la misma tarjeta de antes.

Implementación

Implementa el método opcional 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.
El método recibe un payload YunoCardInfo?, también disponible desde Objective-C:
Para leer los valores por clave, usa rawData:
Para Seamless, configura 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.
En Objective-C:

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 (nil en 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

  1. En sandbox, abre un formulario de tarjeta desde tu app con el callback registrado.
  2. Escribe el número de una tarjeta de prueba. Después del sexto dígito recibes los datos de la tarjeta.
  3. Borra dígitos hasta que queden menos de 6. Recibes null (nil en iOS).
  4. Escribe el número de una tarjeta de otra marca. Recibes los nuevos datos.
  5. Paga con una tarjeta guardada. El callback no se llama.
Los valores provienen de la consulta de tarjeta del entorno que uses, así que las tarjetas de prueba en sandbox pueden devolver datos genéricos del emisor.