Errores de pago en una app: recuperar la compra sin cobrar dos veces
La aplicación no ha recibido respuesta. Eso no demuestra que el pago haya fallado: antes de ofrecer otro intento hay que recuperar la operación anterior.
Para gestionar errores de pago en una app, distingue un rechazo confirmado de un resultado todavía desconocido. Conserva el pedido y sus intentos de pago, comprueba el estado desde el servidor y protege las repeticiones de una misma operación. Verifica las notificaciones del proveedor sin duplicar pedidos ni entregas y revisa los intentos que queden pendientes. Al volver, el cliente debe encontrar la misma compra y una explicación clara. Define también qué sucede con una confirmación tardía, una reserva caducada y un reembolso sin terminar.
Estima tu app con un breve cuestionario
EmpezarEl error que deja al cliente sin saber qué hacer
Has comprado alimentos para recoger antes de salir de viaje. Confirmas en la app del banco y vuelves a la tienda. La pantalla sigue esperando, aparece un error y el pedido no figura en la lista. El banco, sin embargo, ha enviado una notificación. Volver a pagar no parece una decisión cómoda.
Es un ejemplo imaginado, no una incidencia de un cliente nuestro. Sirve para pensar en algo que el diseño del botón no resuelve: qué hace el producto cuando todavía no conoce el resultado. Un mensaje claro ayuda, pero el sistema también debe poder localizar el pedido y comprobar qué ocurrió con el pago.
Esta guía está dirigida a quien construye la aplicación, no a quien busca reclamar un cargo bancario. Nos centramos en bienes físicos y servicios presenciales. Las compras digitales y las suscripciones añaden reglas de las tiendas y del acceso, tratadas en la guía de pagos y suscripciones.
No confundas un rechazo con una respuesta perdida
El proveedor puede rechazar el pago, seguir procesándolo o aceptarlo sin que la respuesta llegue a tu servidor. También puede fallar la conexión del teléfono cuando el servidor ya ha registrado el éxito. Desde la pantalla, todos pueden parecer el mismo error.
Si el rechazo es definitivo, se puede ofrecer otro intento permitido. Si el resultado es desconocido, primero hay que consultar la operación existente. Crear una nueva por impaciencia puede convertir una espera incómoda en un segundo cobro.
El artículo de ingeniería de Stripe sobre idempotencia explica esta diferencia entre una acción y su respuesta. Es una explicación histórica del mecanismo, no una receta actual de integración. Quédate con la idea de producto: no haber recibido la respuesta no demuestra que la operación no se haya realizado.
Guarda un pedido que sobreviva al cierre de la app
La compra necesita una referencia duradera antes de que termine el recorrido. Al volver a abrir, el cliente debería encontrar el pedido pendiente, no una cesta vacía que le obligue a empezar de nuevo. Soporte necesita esa misma referencia para investigar.
Un pedido puede tener varios intentos legítimos de pago, pero no debe nacer un pedido distinto con cada pulsación. Define cómo se sustituye un intento definitivamente fallido, qué importe y moneda se acordaron y cómo se vincula una confirmación al pedido correcto. El servidor debe comprobarlo; la pantalla no es una autoridad suficiente.
Esta continuidad forma parte del diseño del servidor de la aplicación. El objetivo no es guardar una colección de mensajes, sino conservar la historia de una operación que ya puede haber afectado al dinero.
Repetir una operación no es abrir otra
La idempotencia evita que repetir una misma operación produzca efectos adicionales. Si el proveedor ya la ha procesado, puede devolver el resultado anterior dentro de las condiciones y los plazos que documenta. No hace falta que el propietario del producto conozca el código, pero sí que pueda preguntar qué identifica el intento y qué pasa si se repite.
Desactivar el botón evita algunos toques seguidos. No protege por sí solo los reinicios, las peticiones simultáneas o el uso desde otro dispositivo. El servidor necesita sus propias garantías para cobrar, crear el pedido y enviar una instrucción de entrega.
Adyen documenta que el alcance y la vigencia de las claves dependen del proveedor. Conserva la identidad al repetir la misma petición incierta, pero no uses una clave para todas las compras. Una compra nueva o un intento permitido después de un rechazo confirmado deben seguir el proceso previsto por el proveedor. La protección del cobro tampoco deduplica automáticamente tus correos o reservas.
La confirmación no puede depender del regreso del cliente
Alguien puede aprobar la operación y cerrar la app. Si preparar el pedido depende de mostrarle la pantalla de éxito, has convertido un gesto del cliente en una parte frágil del negocio. La guía de Stripe para verificar el estado sitúa esta decisión en el servidor.
Las notificaciones entre servidores, llamadas webhooks, informan de cambios sin exigir que el móvil permanezca abierto. Hay que verificar su autenticidad según el proveedor, localizar el pago y actualizar el pedido de manera segura.
La documentación de webhooks de Stripe advierte de mensajes duplicados. Recibir dos veces un aviso no debería producir dos entregas. Tampoco conviene dejar que un mensaje antiguo sustituya sin comprobación un estado posterior. Haber recibido el aviso y haber terminado el trabajo que provoca son cosas distintas.
*Una analogía del problema: la acción llega aunque su respuesta se pierda.*
¿Tienes una idea de app y quieres el siguiente paso?
Revisar mi ideaCada estado necesita una explicación y una salida
No obligues al cliente a interpretar códigos técnicos. Esta tabla es un modelo original para preparar la conversación con el equipo, no una clasificación universal del proveedor:
| Lo que sabe el servidor | Lo que debe entender el cliente | Siguiente acción |
|---|---|---|
| Resultado desconocido | Se está comprobando el pago existente | Consultar el pedido o contactar, sin un nuevo cobro a ciegas |
| Rechazo definitivo | Este intento no se ha completado | Ofrecer otro intento o método permitido |
| Pago aceptado, pedido en preparación | Pagar y preparar no son lo mismo | Mostrar referencia y progreso del pedido |
| Confirmación después de caducar la reserva | El pago necesita una resolución | Aplicar la recuperación, liberación o devolución acordada |
| Reembolso iniciado sin confirmación | La devolución todavía no está terminada | Mostrar su estado y una vía de ayuda |
Una alerta bancaria puede referirse a una autorización o retención, no a un cargo final. Explica lo que está verificado. No prometas que el dinero se ha cobrado o devuelto solo porque ha aparecido una señal intermedia.
Una confirmación tardía también puede complicar el pedido
El horario de recogida puede caducar mientras se aclara el pago. En una cita ocurre algo parecido si el hueco ya se ha ofrecido a otra persona. Recibir el dinero después no convierte automáticamente la reserva en disponible.
Acuerda qué hará el negocio: mantener el pedido si todavía es posible, proponer otra opción o tramitar la devolución del pago aceptado. Si solo se autorizó un importe, puede corresponder liberar la retención en lugar de devolver un cargo. La interfaz debe distinguir estas dos operaciones.
En un marketplace, comprador, vendedor y personal necesitan compartir esa regla. Las obligaciones concretas y los plazos dependen del mercado y del acuerdo de pago. No inventes una fecha universal para tranquilizar al cliente.
Soporte debe poder reconstruir la historia
Una persona que pregunta por su pedido necesita una respuesta, no una investigación desde cero. Soporte debería ver la referencia, los intentos vinculados, los estados verificados y la acción de recuperación ya iniciada. Pedir capturas puede complementar el caso, pero no sustituir el registro del sistema.
Limita los permisos para actuar sobre dinero y conserva quién hizo qué, por qué y con qué resultado. Evita números de tarjeta, credenciales bancarias y datos personales innecesarios en las notas y en la analítica.
Además, asigna a alguien la revisión de operaciones sin resolver. La conciliación con el proveedor sirve de respaldo cuando una notificación no llega. Debe utilizar sus mecanismos y límites; consultar sin parar todos los pagos no es una estrategia de recuperación.
Pide una demostración de los fallos antes de publicar
El equipo debería mostrar qué ocurre al perder la respuesta después de aceptar el pago, pulsar dos veces, recibir un aviso duplicado y reabrir la app. Añade una confirmación posterior a la caducidad y una respuesta lenta a un reembolso. Se prueba en un entorno seguro, no con el dinero de un cliente ajeno al ensayo.
Comprueba que cada prueba deja el pedido en el estado previsto, sin cobros ni entregas duplicados, y que soporte puede explicar lo ocurrido. Algunos casos deben terminar sin cobrar ni entregar; otros requieren liberar una autorización o tramitar un reembolso. La guía de revisión antes del lanzamiento sitúa estas pruebas dentro del trabajo general.
En el plan de analítica, separa resultados desconocidos y rechazos confirmados. Pulsar Pagar no equivale a generar ingresos. Para hablar con Appfyl o completar un breve formulario de proyecto, lleva un ejemplo de pedido problemático y la recuperación esperada. Será mucho más útil que pedir un botón infalible.
Convierte la investigación en un plan
Appfyl convierte tu idea en un plan claro, una lista de funciones y el primer tramo de trabajo.
Hablar del plan de la appPuntos clave
- Distingue el resultado desconocido del rechazo confirmado.
- Conserva el pedido y la identidad de la operación al repetir o reabrir.
- Verifica los avisos y evita duplicar entregas, no solo cobros.
- Acuerda y prueba las confirmaciones tardías, las cancelaciones y las devoluciones.
Enlaces útiles
Preguntas frecuentes
No. Primero distingue un resultado definitivo de uno desconocido. La repetición necesita una identidad correcta, un comportamiento admitido por el proveedor y límites razonables. Una repetición genérica puede duplicar el trabajo.
Reduce pulsaciones repetidas, pero no protege los reinicios, los dispositivos distintos ni los mensajes tardíos. Úsalo como ayuda visual junto a la protección del servidor.
No. Las existencias o la reserva pueden haber caducado. Guarda por separado el estado del pago y del pedido y define cómo resolver sus diferencias.
Solo si el proceso real permite esa promesa. Solicitarla, obtener confirmación y que el banco la muestre son etapas distintas. Comunica progreso verificado, no un plazo inventado.