Proceso de lanzamiento

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.

Una viajera consulta su móvil bajo la marquesina de una terminal de ferris con una bolsa de compra
Una viajera consulta su móvil bajo la marquesina de una terminal de ferris con una bolsa de compra
Respuesta directa

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

Empezar

El 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.

Un recibo llega a una bandeja mientras la respuesta queda interrumpida en un conducto separado

*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 idea

Cada 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 servidorLo que debe entender el clienteSiguiente acción
Resultado desconocidoSe está comprobando el pago existenteConsultar el pedido o contactar, sin un nuevo cobro a ciegas
Rechazo definitivoEste intento no se ha completadoOfrecer otro intento o método permitido
Pago aceptado, pedido en preparaciónPagar y preparar no son lo mismoMostrar referencia y progreso del pedido
Confirmación después de caducar la reservaEl pago necesita una resoluciónAplicar la recuperación, liberación o devolución acordada
Reembolso iniciado sin confirmaciónLa devolución todavía no está terminadaMostrar 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 app

Puntos 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

¿Conviene repetir automáticamente cualquier petición fallida?

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.

¿Basta con bloquear el botón de pago?

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.

¿Un pedido pagado siempre se puede entregar?

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.

¿Puede soporte prometer una devolución inmediata?

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.