Entender los estados de las tarjetas guardadas

Customer App puede mostrar un área de tarjetas guardadas solo cuando el proyecto actual ofrece la función habilitada de tarjetas guardadas de Braintree. Por tanto, la opción del perfil, la lista de tarjetas y las acciones Agregar tarjeta y Eliminar tarjeta son condicionales. Su presencia no garantiza que estén disponibles en todas las experiencias de la aplicación.

Esta guía no confirma que Stripe admita tarjetas guardadas ni ofrece una opción actual para elegir una tarjeta predeterminada o editarla.

Reconocer el estado visible

Estado	Interpretación segura
No aparece la opción en Perfil	No se determinó que la función de tarjetas guardadas esté disponible en el contexto actual; no se deduce un motivo ni una conclusión sobre la cuenta.
Carga	Customer App está determinando la capacidad o solicitando la lista actual.
No disponible	El proyecto actual no devolvió la función compatible de tarjetas guardadas.
Vacío	La respuesta autorizada no contiene filas de tarjetas para la vista actual.
Lista enmascarada	Customer App muestra la marca y los últimos cuatro dígitos de cada referencia devuelta.
Error de carga	Se desconoce el estado de la lista actual; la vista anterior puede estar desactualizada.

Que la lista esté vacía o no disponible no demuestra que el cliente nunca haya guardado una tarjeta con un proveedor, que no tenga tarjetas en otro proyecto ni que se pueda agregar una tarjeta. Una fila enmascarada no demuestra que la referencia siga siendo utilizable.

Presentación enmascarada y titularidad

La lista solo debe exponer los datos mínimos necesarios para distinguir una referencia guardada, como la marca y los últimos cuatro dígitos. No debe exponer el número completo, el código de seguridad, un token del proveedor, una credencial de sesión, un identificador interno ni una respuesta del proveedor.

Cada operación de listar, agregar, actualizar o eliminar debe autorizarse para la cuenta, el proyecto, la función de pago configurada y la tarjeta guardada de destino exactos. Que una fila haya llegado a la interfaz no demuestra por sí solo su titularidad. Al cambiar la cuenta, el proyecto o la sesión, deben invalidarse las filas anteriores, la capacidad guardada en caché, el trabajo pendiente del proveedor y las funciones de retorno tardías.

Agregar una tarjeta implica pasar a un proveedor externo

Cuando está disponible Agregar tarjeta, la ruta actual de Braintree abre una superficie externa integrada del proveedor. Esa superficie puede recopilar datos de pago confidenciales fuera del estado habitual del formulario de Customer App. Abrirla es un paso a otro proveedor; no demuestra que se haya creado una tarjeta.

Cerrar la superficie, recibir un mensaje del proveedor o actualizar la lista no establece por sí solo que Ordering.co haya guardado la referencia para la cuenta actual. Solo un resultado nuevo y autorizado de Ordering.co puede establecer el estado de la lista enmascarada resultante. Si el paso se cierra, falla o devuelve un resultado no reconocido, considera desconocido el resultado y no repitas automáticamente la acción.

Esta guía no incluye pasos para ingresar los datos de la tarjeta ni instrucciones para configurar el proveedor.

Eliminar una referencia guardada

Eliminar es una acción independiente sobre una cuenta financiera y debe requerir confirmación explícita para una tarjeta enmascarada específica. Que desaparezca una fila local no demuestra que hayan convergido los estados del proveedor y Ordering.co.

Si se pierde la respuesta, se cierra la aplicación o cambia la cuenta/proyecto, mantén desconocido el resultado hasta que haya una lista nueva y autorizada. No envíes una segunda solicitud de eliminación solo porque siga apareciendo la fila anterior; tampoco infieras que eliminar una referencia guardada cancele un cargo, pedido, suscripción, movimiento de billetera o cuenta del proveedor.

Solucionar problemas sin usar datos de la tarjeta

Síntoma	Respuesta segura
No aparece Tarjetas guardadas	Confirma la cuenta y el proyecto activos; no cambies la configuración del proveedor de pagos.
La lista está vacía o no disponible	Fuera de la vista actual autorizada, considera desconocidos tanto la disponibilidad como la titularidad.
No se carga la lista	Intenta una sola actualización habitual y autorizada; nunca ingreses datos de la tarjeta como prueba.
No se abre o se cierra la superficie para agregar tarjeta	Deja el resultado sin resolver; no pegues una dirección o credencial del proveedor en otra superficie.
No aparece la tarjeta que se agregó	Antes de volver a intentarlo, comprueba con una sola lista nueva y autorizada.
Eliminar devuelve un error o no produce resultado	Antes de repetir, vuelve a comprobar la lista; no pruebes con otra tarjeta guardada.
Aparece una tarjeta después de cambiar de cuenta/proyecto	Detente, evita seleccionarla o eliminarla, cierra sesión si es seguro y usa un canal de soporte aprobado.

Para la documentación o la solución de problemas, nunca compartas el número completo de la tarjeta, el código de seguridad, un token, una referencia del proveedor, un valor de sesión, una captura de datos de pago ni contenido copiado de una vista web integrada.

Requisitos de accesibilidad

Los estados de disponibilidad, carga, vacío, error, tarjeta enmascarada, Agregar tarjeta, Eliminar tarjeta, confirmación, ocupado, éxito, resultado desconocido y cambio al proveedor externo requieren nombres, roles, estados semánticos diferentes y un foco predecible. Se debe poder distinguir una fila de tarjeta sin depender solo del icono o estilo de la marca.

La etiqueta enmascarada debe anunciar la marca y los últimos cuatro dígitos sin leer los caracteres decorativos de enmascaramiento como un número completo. Al eliminar, se debe identificar la tarjeta enmascarada correspondiente y mantener esa acción independiente de la fila. Al abrir y cerrar la superficie externa, el foco debe moverse deliberadamente y los errores deben anunciarse sin revelar datos de pago. Estos son requisitos de accesibilidad; no confirman que actualmente haya soporte.

Qué puede afectar las tarjetas guardadas

La disponibilidad y el comportamiento pueden variar según cómo se detecta la función, las familias de pasarelas compatibles, los campos de la lista, la vinculación con cuenta/proyecto/sesión, el estado del proveedor en caché, el origen o manejo de mensajes de la superficie externa, el resultado de agregar/eliminar, el comportamiento predeterminado/de edición, el enmascaramiento, la navegación o la accesibilidad. Esta guía no confirma el comportamiento de una API ni del proveedor en producción.

Guías relacionadas: Descripción general del perfil y la cuenta · Entender la disponibilidad de métodos de pago · Entender los fallos y reintentos del pago · Entender la privacidad y el consentimiento · Entender el comportamiento de la plataforma y la accesibilidad