Elegir un método de pago
Customer App puede mostrar opciones de pago después de leer el negocio, el carrito, el contexto del pago, el estado del cliente y la capacidad del dispositivo actuales. Una opción en pantalla es candidata para ese estado; no demuestra que se pueda autorizar, cobrar, confirmar ni usar para crear un pedido.
No selecciones, reabras ni cambies la opción de pago para comprobar si se completó un intento anterior. La selección, el retorno externo, el mensaje del proveedor, el cierre de un cuadro o el cambio de pantalla no son recibos autorizados de pago o pedido.
Qué significa la lista de métodos
La lista puede construirse a partir de la configuración actual del negocio y el proyecto, el estado del carrito y la entrega, el estado del cliente o invitado, la plataforma del dispositivo, la capacidad del proveedor y la variante del pago. Puede cambiar si cambia cualquiera de esos datos.
| Estado visible | Interpretación segura |
|---|---|
| Cargando opciones | No se han resuelto la elegibilidad ni las lecturas de capacidad de soporte |
| Una o más opciones | La aplicación tiene métodos candidatos para el estado actual |
| No hay opciones | No se devolvió ni conservó una opción elegible para el estado actual |
| Desaparece una opción | Cambió una condición pertinente de carrito, cuenta, dispositivo, proyecto o proveedor |
| Una opción está deshabilitada | Sigue sin resolverse al menos un requisito actual |
No infieras que un método oculto no esté disponible en ningún lugar ni que uno visible se aplique a todos los carritos.
La selección y la persistencia son distintas
| Capa | Qué puede ocurrir | Qué no demuestra |
|---|---|---|
| Lectura de lista | Customer App recibe y filtra datos de capacidad de métodos | Autorización del pago ni preparación del proveedor |
| Selección local | Se resalta una opción o se abre su pantalla de detalles | Que el carrito haya guardado la opción |
| Persistencia en el carrito | Se escribe en el carrito el método seleccionado o el estado de soporte | Que lo haya aceptado un proveedor |
| Paso al proveedor | Una superficie integrada, externa, de redirección, SDK o nativa recibe el control | Liquidación del pago ni creación del pedido |
| Confirmación | Ordering.co concilia un carrito o grupo pendiente | Que hayan terminado todos los efectos de proveedor, billetera o pedido |
| Estado del pedido | Se ve un pedido autorizado de Ordering.co | Que se hayan completado todos los efectos financieros externos |
Algunas familias de métodos guardan la selección automáticamente y otras esperan datos adicionales del método. Considera independientes el resaltado visible y el estado guardado en el carrito, salvo que el pago actual los haya conciliado.
Selección automática y saldo cero
Cuando queda un solo método, el código fuente actual puede seleccionarlo automáticamente. Esa elección automática también puede iniciar la persistencia habitual. No es una autorización del cliente, confirmación de pago ni consentimiento para una acción del proveedor externo.
Cuando el saldo actual es cero, Customer App puede quitar la selección de pago local e indicar que no se necesita un método de pago. Esa presentación no demuestra el total final del carrito, el resultado de la realización, la liquidación de un descuento, el estado de la billetera ni la creación del pedido.
Límites de pagos externos y nativos
Las familias de métodos pueden usar clases de paso distintas:
| Clase de paso | Límite seguro para clientes |
|---|---|
| Vista integrada del proveedor | El contenido web, los mensajes, la navegación y el estado de Ordering.co se actualizan por separado |
| Redirección externa | Salir de Customer App y volver no establece éxito ni cancelación |
| SDK del proveedor | Un resultado del SDK local es una entrada del proveedor, no un recibo de Ordering.co |
| Hoja de billetera nativa | La capacidad del dispositivo y la confirmación local siguen siendo independientes de la liquidación del carrito/pedido |
| Superficie de instrumento guardado | La presentación enmascarada y la selección siguen siendo independientes de la titularidad y autorización |
Cerrar, cancelar, volver o ver un resultado del proveedor puede dejar el estado desconocido. No uses Atrás, volver a la aplicación, reabrir ni otro método para diagnosticarlo.
Tarjetas guardadas, billeteras y variantes del pago
- Las tarjetas guardadas pueden requerir comprobaciones independientes de capacidad, credencial, titularidad de cuenta, lista, selección y proveedor. Que una tarjeta esté enmascarada no demuestra que se pueda usar.
- La disponibilidad de la billetera y su saldo son distintos de la disponibilidad de un método de pago. En pagos agrupados, elegir o quitar una billetera puede cambiar el estado compartido del grupo, no solo la presentación local.
- Los carritos de tarjetas de regalo y saldo cero pueden usar fuentes de métodos distintas u omitir la lista habitual.
- El pago agrupado puede ofrecer familias de métodos y reglas de liquidación distintas de las del pago de un solo negocio. Un miembro o una opción visible no demuestra la elegibilidad de todo el grupo.
- Para algunos métodos, el pago como invitado puede requerir convertir la cuenta. La conversión, sesión, transferencia de datos de invitado, pago y realización del pedido siguen siendo resultados distintos.
Las credenciales no son una autorización de pago
Customer App o un componente del proveedor pueden leer datos de capacidad o credenciales públicas de integración para decidir si se puede mostrar un método. Esas lecturas no autorizan el pago, no identifican al cliente o carrito correctos, no demuestran que el instrumento guardado pertenezca a la cuenta actual, no confirman el contexto financiero final ni crean un pedido.
Un resultado de pago seguro debe seguir vinculado a la cuenta, proyecto, sesión, carrito o grupo, negocio, método, revisión financiera y generación de operación actuales y autorizados. Los detalles del método que ve el cliente, las respuestas del proveedor y la navegación no sustituyen esa liquidación autorizada.
Resultados desconocidos o parciales
| Estado observado | Respuesta segura |
|---|---|
| Se resalta una opción, pero no está claro el estado del carrito | Considera sin resolver la persistencia de la selección |
| No se abre la superficie del proveedor | No supongas que no ocurrió una lectura del método ni una escritura del carrito |
| Se cierra la superficie del proveedor o vuelve a la aplicación | No infieras éxito, cancelación ni ausencia de efecto |
| Termina la carga con un error | Considera independientes el proveedor, pago, billetera, carrito y pedido |
| Cambia el método después de cambiar cuenta o proyecto | Considera obsoleto el resultado anterior |
| Avanza un miembro de un grupo | Mantén sin resolver todos los demás miembros |
| Aparece un pedido | Úsalo solo como estado actual autorizado del pedido de Ordering.co |
| No aparece ningún pedido | La ausencia en una vista no demuestra que no hubiera ningún efecto financiero |
Mientras no esté resuelta la liquidación, no selecciones otro método ni repitas acciones de pago, confirmación, billetera o realización. Usa Pedidos como estado de Ordering.co únicamente; si persiste la incertidumbre, recurre a un canal de soporte aprobado.
Solucionar problemas de forma segura
| Lo que observas | Siguiente comprobación segura |
|---|---|
| La lista de métodos sigue cargando | Espera sin reabrir Pago ni cambiar el contexto para probarlo |
| No aparece ningún método | Confirma el carrito y el estado de entrega actuales; no infieras disponibilidad global |
| Se selecciona el único método | Considéralo selección automática, no autorización de pago |
| La selección deja de aparecer resaltada | Considera sin resolver la selección local y persistida; no repitas para diagnosticar |
| Un método solicita datos de cuenta | Usa el límite independiente de cuenta/conversión de invitado; no infieras compatibilidad de pago |
| Falta una tarjeta guardada o una billetera | No agregues, elimines ni cambies instrumentos para diagnosticar |
| Se cierra inesperadamente un proveedor | Mantén desconocido el resultado y sigue las indicaciones para no repetir |
| Cambia la cuenta, proyecto, carrito o grupo | Descarta la vista obsoleta y usa únicamente el contexto actual autorizado |
Los informes de soporte deben usar solo una clase de estado sin valores, como “selección de método de pago sin resolver”. No incluyas información de pago, datos de tarjeta, credenciales, tokens, mensajes de métodos o proveedores, identificadores de cuenta/carrito/pedido, enlaces ni capturas privadas.
Privacidad y accesibilidad
- Ingresa los datos de pago solo en la superficie de pago autorizada de la app. Nunca los envíes a soporte ni los compartas fuera del flujo de pago.
- Las etiquetas de método, el estado de selección, los estados deshabilitado/ocupado, errores, cuadros y consecuencias de pasos externos requieren nombres accesibles y anuncios claros.
- Una lista horizontal de métodos debe poder usarse sin depender solo de logotipos, color, bordes, movimiento o respuestas hápticas.
- Con texto grande, las etiquetas y errores deben adaptarse sin ocultar la opción activa ni la advertencia de no repetir. El retorno del proveedor y el cierre del cuadro deben devolver el foco de forma predecible.
- El comportamiento del lector de pantalla, teclado, conmutador, área segura, Atrás y movimiento reducido puede variar según el dispositivo y la versión de la aplicación.