onCardInfoChanged se invoca con la marca, el tipo, la categoría, el emisor y el país de la tarjeta mientras el comprador escribe el número de tarjeta en el formulario de tarjeta. Recibes estos datos antes de que el comprador envíe el formulario, para que puedas adaptar tu checkout en tiempo real: mostrar la marca de la tarjeta o el banco emisor en el resumen de tu pedido, explicar una promoción que aplica solo a tarjetas de crédito, o adaptar un mensaje al país del banco emisor.
Es informativo: el pago funciona igual con o sin este controlador. El SDK ya consulta los datos de la tarjeta a partir del sexto dígito para mostrar la marca y cargar las cuotas, y este controlador 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.
Disponible en iOS y Android desde la versión 3.1.0 del SDK. El SDK lo llama desde cada formulario de tarjeta que muestra para una tarjeta nueva, en pagos y en inscripciones. No se llama para tarjetas guardadas, porque el comprador no escribe un número.
Qué recibes
Un objetoCardInfo, o null (nil en iOS).
- 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. - 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. 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
iincambiado. - En el hilo principal, para que puedas actualizar tu UI directamente.
La entrega de null
El controlador recibe null (nil en iOS) cuando una tarjeta que ya recibiste deja de aplicar: el número baja de 6 dígitos, el campo se borra o la consulta falla. Borra u oculta lo que mostraste para la tarjeta anterior. La primera llamada nunca es null.
No se envía nada cuando el formulario de tarjeta se cierra, cuando el comprador paga o cuando el comprador elige otro método de pago. Si tu UI necesita restablecerse en esos casos, hazlo de tu lado.
Firma
En iOS, implementa el método en tuTransactionController. En Android, encadena onCardInfoChanged en el TransactionConfig del pago o de la inscripción: devuelve una nueva configuración, así que usa el valor devuelto.
- iOS
- Android
onCardInfoChanged, o con onCardInfoChanged(null), no recibe nada.
Buenas prácticas
- Mantén el manejador ligero. 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.
- Trata cada llamada como el estado actual del formulario, no como un valor final. El comprador aún 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.
Relacionado
- Escuchar eventos. Los otros controladores informativos.
onInstallmentSelected. La opción de cuotas que el comprador elige en el mismo formulario de tarjeta.- Resumen de controladores. Cómo se conectan los controladores en cada plataforma.