Una compra pendiente parece una venta, pero el dinero no ha llegado, y concederla antes de tiempo regala el producto

Alguien toca comprar en tu app. Tus registros muestran un pedido nuevo, tu listener de facturación se dispara y entregas la mercancía. En la mayoría de las compras eso es exactamente lo correcto. En una compra pendiente es un error, porque el pedido existe pero el dinero no. El cliente eligió un método de pago que se liquida más tarde, la tienda todavía espera cobrar, y acabas de entregar una función de pago por un cargo que quizá nunca se liquide. Este es el primo silencioso de un reembolso. Aquí no se revierte nada, porque nunca se cobró nada. Simplemente regalaste el producto.

Una compra pendiente es un pedido real en un estado aún no pagado, y tanto App Store como Google Play tienen uno. Ambas tiendas te dicen claramente que esperes. La trampa es que un pedido pendiente se parece casi por completo a uno completado en tu código, así que una integración que trata cada compra nueva como una venta entrega mercancía en pedidos que la tienda todavía intenta cobrar. Gestiónalo bien y no pierdes nada. Gestiónalo mal y cada pago lento que se cae es puro coste, entregado a tu cuenta.

Qué es en realidad una compra pendiente

Una compra pendiente es un pedido que la tienda ha registrado pero aún no ha cobrado. El comprador inició el flujo, la tienda lo aceptó, y la liquidación ocurre en un lugar que tu app no puede ver. Google Play llama a esto el estado PENDING. Apple lo llama una transacción pendiente, o diferida. Nombres distintos, mismo hecho: la tienda mantiene un pedido abierto mientras espera cobrar, y te ha dicho que no trates ese pedido como dinero.

Google Play: el pago ocurre en otro sitio

Algunos métodos de pago se liquidan fuera de línea. El efectivo en una tienda física, las transferencias bancarias y parte de la facturación a través del operador requieren pasos adicionales entre el toque y el cargo. Cuando un cliente elige uno, Google devuelve la compra en el estado PENDING en lugar de PURCHASED. En un pago en efectivo, el cliente recibe un código por notificación y por correo, lo lleva a una tienda participante y paga al cajero. Hasta que eso ocurre, Google no ha cobrado nada, y tú tampoco. La regla de Google es una línea: usa getPurchaseState() y concede el derecho solo cuando el estado sea PURCHASED. También te dice que no confirmes una compra mientras esté en PENDING, porque la confirmación corresponde a un pedido pagado, no a uno prometido.

Apple: la compra espera el toque de otra persona

El estado pendiente de Apple significa que la transacción necesita una acción externa antes de poder completarse. La más común es Ask to Buy, donde un niño inicia una compra y un organizador de la familia tiene que aprobarla. En StoreKit 2, la llamada de compra devuelve Product.PurchaseResult.pending. En el StoreKit anterior, la transacción se informa como diferida. En cualquier caso, Apple no ha cobrado a nadie, y la transacción finalizada, si llega, arriba de forma asíncrona a través de Transaction.updates. Muestra al cliente un estado de espera y no desbloquees nada hasta que aterrice la transacción completada.

Por qué conceder una compra pendiente te cuesta dinero de verdad

La pérdida aquí no es del tipo reembolso, donde el dinero que contabilizaste se retira. Es peor en un aspecto concreto: no hay dinero que retirar, porque nunca se cobró nada.

Tú entregas y la tienda nunca cobra

Cuando desbloqueas con un pedido pendiente que después se cancela, ya has gastado para servirlo. El cómputo que ejecutó la función, las llamadas a API de terceros que pagaste, el almacenamiento que reservaste y, para un consumible, el pago real de lo que vendiste. Todo eso sale por la puerta en un pedido que no generó ingresos. Un reembolso al menos parte de un cargo que sí ocurrió. Una compra pendiente concedida por error nunca tuvo cargo alguno, así que ni siquiera aparece como dinero que sale. Aparece como nada, que es justo la razón por la que es fácil pasarla por alto y fácil de repetir.

La señal de cancelación y qué significa

La tienda sí te avisa cuando un pedido pendiente muere. En Google Play, un producto de pago único que se cae envía una notificación ONE_TIME_PRODUCT_CANCELED, tipo 2, y una suscripción que estaba pendiente envía SUBSCRIPTION_PENDING_PURCHASE_CANCELED, tipo 20. Cuando esos mismos pedidos sí prosperan, recibes ONE_TIME_PRODUCT_PURCHASED, tipo 1, o SUBSCRIPTION_PURCHASED, tipo 4. En Apple no hay evento de cancelación que capturar, porque una transacción diferida que se rechaza sencillamente nunca se convierte en una transacción completada. Si desbloqueaste antes de tiempo, ese silencio es la factura.

La ventana y quién espera a quién

Una compra pendiente no es un reloj contra el que compites. Es un reloj que, desde tu lado, no ha empezado.

Google Play da al cliente días, no minutos

Un pago en efectivo o por transferencia bancaria se liquida según el calendario del cliente, no el tuyo. El pedido permanece en PENDING hasta que el cliente paga o la ventana se agota y Google lo cancela. Tu propia ventana de confirmación de tres días, la que reembolsa automáticamente una compra que no confirmas, ni siquiera empieza hasta que la compra pasa de PENDING a PURCHASED. Así que no hay prisa por servir un pedido pendiente. Solo está la disciplina de esperar a que el estado cambie.

La aprobación de Apple está en el teléfono del organizador de la familia

Una solicitud de Ask to Buy llega al dispositivo del organizador como un aviso que aprueba o rechaza cuando puede. Eso puede ser minutos, horas o un día después, y tu app no puede acelerarlo. El único comportamiento correcto es reflejar el estado de espera y dejar que StoreKit te entregue la transacción completada si la aprobación llega y cuando llegue.

Cómo gestionar las compras pendientes sin fugas

Todo el trabajo se reduce a cuatro hábitos. Ninguno es difícil, y saltarse cualquiera de ellos es por donde se va el dinero.

Concede en el estado pagado, nunca en el pendiente

En Google Play, comprueba getPurchaseState() y concede solo en PURCHASED, y no confirmes una compra mientras esté en PENDING. En Apple, desbloquea solo en una transacción completada y nunca en el resultado pendiente. Esta única regla cierra toda la fuga. Todo lo demás consiste en asegurarte de que de verdad te enteras cuando llega el estado pagado.

Vuelve a comprobar cuando la app regresa

La transición de pendiente a pagado suele ocurrir mientras tu app no se está ejecutando. En Google Play, llama a queryPurchasesAsync() en tu manejador onResume() para recoger los pedidos que pasaron a PURCHASED en segundo plano, y mantén tu listener de Real-time Developer Notifications como la fuente de verdad del lado del servidor. En Apple, escucha Transaction.updates durante toda la vida de la app, porque una transacción aprobada puede llegar mucho después de que la llamada de compra original haya vuelto.

Activa el soporte de pendientes y prueba ambos finales

Google exige que llames a enablePendingPurchases() cuando construyes el BillingClient, y admitir transacciones pendientes para productos de pago único es obligatorio, no opcional. Pruébalo antes de publicar. Los testers con licencia obtienen dos instrumentos de prueba adicionales para formas de pago diferidas, donde el pago se completa automáticamente o se cancela automáticamente al cabo de un par de minutos, para que puedas observar de principio a fin tanto la ruta de pago como la ruta de caída.

Dile al cliente que el pedido no está terminado

Un comprador pendiente es un cliente real en medio de una compra, no un fallo. Muéstrale que el pedido espera su pago o una aprobación, y dale un camino claro de vuelta para terminarlo. Un estado pendiente silencioso pierde ventas que uno bien etiquetado recupera, porque la mayoría de estos compradores todavía quieren la cosa y solo les queda un paso.

Los mismos flujos de Real-time Developer Notifications y App Store Server Notifications que RefundHalt ya lee para reembolsos y contracargos también llevan estas señales. La notificación de compra que dice que un pedido pendiente por fin se liquidó, y la de cancelación que dice que no, aterrizan en tu panel junto al resto de tus eventos de ingresos, así que un pedido pendiente que se cayó es algo que puedes ver en lugar de algo que pagaste por accidente.

La versión corta

Una compra pendiente es un pedido sin pago, y ambas tiendas son explícitas en que debes esperar. Google Play devuelve los pedidos en efectivo, por transferencia bancaria y parte de la facturación del operador en un estado PENDING y te dice que concedas acceso solo en PURCHASED. Apple devuelve una transacción pendiente o diferida para Ask to Buy y otras acciones requeridas, y entrega la transacción completada más tarde a través de Transaction.updates. Desbloquea en el estado pagado, vuelve a comprobar cuando tu app se reanude, activa y prueba el soporte de pendientes, y etiqueta el pedido en espera para el cliente. Haz eso y una compra pendiente no te cuesta nada. Sáltatelo y entregarás un producto de pago por un cargo que nunca llegó, que es la única pérdida sin recibo al que señalar.