Cómo gestionar las solicitudes de reembolso del App Store (y la consumption request)
Reembolsos del App Store en suscripciones: quién decide, la notificación CONSUMPTION_REQUEST, qué enviar a Apple en 12 horas y qué hacer después.

En el App Store, nunca emites tú mismo el reembolso de una suscripción y nunca respondes a una disputa de tarjeta. Apple es el comerciante: cobra el pago, decide sobre los reembolsos y trata con el banco del cliente. Lo que puedes hacer es más limitado, pero sigue siendo útil: contar a Apple cómo usó realmente el cliente lo que pagó, reaccionar correctamente cuando se concede un reembolso y detectar patrones de abuso.
Esta guía cubre ese proceso para las suscripciones con renovación automática. Se ciñe a la documentación de Apple, sobre todo Send Consumption Information, el cuerpo ConsumptionRequest, la referencia de notificationType y Get Refund History (todo consultado en noviembre de 2026).
Cómo piden los clientes un reembolso
La guía de Apple para gestionar las notificaciones de reembolso enumera las formas en que un cliente puede pedir que le devuelvan su dinero:
- contactando con el soporte al cliente de Apple;
- usando el sitio de autoservicio de Apple, reportaproblem.apple.com;
- pidiendo un reembolso al emisor de su medio de pago.
Hay una cuarta vía que controlas tú: tu app puede abrir la hoja de reembolso de Apple con beginRefundRequest(in:) de StoreKit. Apple sugiere llamarla desde los ajustes de la cuenta o un menú de ayuda. La hoja muestra la compra y una lista de motivos, y la documentación de Apple dice que el App Store tarda hasta 48 horas en aprobar o denegar la solicitud.
Sea cual sea la vía, la decisión es de Apple. No tienes ningún botón para aprobar o rechazar.
Las notificaciones que recibirás
Si tienes configuradas las App Store Server Notifications V2, los reembolsos producen un pequeño conjunto de eventos:
| Notificación | Qué significa |
|---|---|
CONSUMPTION_REQUEST |
Un cliente ha iniciado una solicitud de reembolso y Apple te pide datos de consumo |
REFUND |
Apple ha reembolsado una transacción |
REFUND_DECLINED |
Apple ha rechazado una solicitud de reembolso |
REFUND_REVERSED |
Apple ha revertido un reembolso que había concedido, por una disputa abierta por el cliente |
DID_CHANGE_RENEWAL_STATUS con AUTO_RENEW_DISABLED |
Entre otros casos, el sistema desactivó la renovación automática porque el cliente solicitó un reembolso desde tu app |
REVOKE |
El acceso mediante En Familia o un grupo terminó, por ejemplo porque se reembolsó al comprador |
El payload de CONSUMPTION_REQUEST incluye un consumptionRequestReason con el motivo que dio el cliente. Apple documenta cinco valores: UNINTENDED_PURCHASE, FULFILLMENT_ISSUE, UNSATISFIED_WITH_PURCHASE, LEGAL y OTHER. Guárdalo. Con el tiempo te dice si los reembolsos vienen de compras accidentales, de errores o de gente a la que simplemente no le gustó el producto.
Responder a la consumption request
Apple dice que «usa diversos factores» para decidir un reembolso, y que la información de consumo que envías es uno de ellos. Es tu única forma de poner hechos delante del revisor.
Las reglas
La documentación de Apple es estricta en tres puntos:
- Primero el consentimiento. Solo puedes enviar datos si el cliente consintió compartirlos con Apple. Si no lo hizo, Apple dice que no respondas en absoluto a la
CONSUMPTION_REQUEST. El servidor rechaza con un error HTTP 400 cualquier solicitud en la quecustomerConsentedno seatrue. - 12 horas. Responde en las 12 horas siguientes a recibir la notificación.
- El consentimiento es cosa tuya. Apple afirma que eres «el único responsable de obtener un consentimiento válido», que debe ser libre, específico, informado e inequívoco, y que no debes usar para ello el aviso de App Tracking Transparency. Si adoptas la API, también tienes que declarar el uso de los datos en los detalles de privacidad de tu app.
La solicitud
Llamas a PUT https://api.storekit.apple.com/inApps/v2/transactions/consumption/ seguido del ID de transacción de la notificación. El cuerpo ConsumptionRequest tiene cinco campos:
| Campo | Qué poner |
|---|---|
customerConsented |
true, el único valor que acepta Apple |
deliveryStatus |
DELIVERED, o uno de UNDELIVERED_QUALITY_ISSUE, UNDELIVERED_WRONG_ITEM, UNDELIVERED_SERVER_OUTAGE, UNDELIVERED_OTHER |
consumptionPercentage |
Cuánto se consumió, en milésimas. Debe ser 0 si el artículo no se entregó |
refundPreference |
Opcional: GRANT_FULL, GRANT_PRORATED o DECLINE |
sampleContentProvided |
Si ofreciste una muestra gratuita, una prueba o una descripción de la funcionalidad antes de la compra |
Para las suscripciones con renovación automática, hay una restricción importante: si eliges GRANT_PRORATED, no envíes consumptionPercentage. Apple calcula ella misma el porcentaje para las suscripciones.
Elegir qué decir
Sé honesto, porque es lo correcto y porque Apple tiene la última palabra de todos modos. Un conjunto de reglas sencillo:
- La app falló (caída, funcionalidad rota, contenido nunca desbloqueado): pon el estado
UNDELIVERED_*correspondiente, un consumo de 0 yGRANT_FULL. Pelear un reembolso por algo que no funcionó no tiene sentido. - Compra accidental, sin uso:
DELIVERED, consumo de 0 o casi 0, yGRANT_FULLo ninguna preferencia. - Uso real y sostenido durante el periodo:
DELIVEREDyDECLINEoGRANT_PRORATED, según tu política. - Prueba gratuita antes del periodo de pago: pon
sampleContentProvidedentrue.
Las cifras deben salir de tus propios datos de uso, medidos de la misma forma para todos los clientes. Eso significa que necesitas un uso ligado a la transacción del App Store, lo que en la práctica implica fijar un appAccountToken en la compra para poder asociar la transacción de Apple a tu usuario.
Cuando se concede un reembolso
Una notificación REFUND significa que el dinero se ha ido. La referencia de notificaciones de Apple dice que el revocationDate de la transacción contiene la fecha del reembolso y revocationReason el motivo. Hay dos valores de motivo:
0: reembolsado por otros motivos, por ejemplo una compra accidental;1: reembolsado por un problema real o percibido en tu app.
Pasos prácticos:
- Revoca el acceso de la transacción reembolsada, y dilo en la app con un mensaje breve. La guía de Apple recomienda «mensajes contextuales en la app para cualquier acción que tomes a raíz del reembolso».
- Registra el motivo. Una proporción creciente del motivo
1es una señal de producto, no de facturación. - Vigila las reversiones. Si llega un
REFUND_REVERSED, Apple dice que debes restablecer el contenido o el servicio. Para las suscripciones con renovación automática, la fecha de renovación no cambia. - Recupera los eventos perdidos. Get Refund History devuelve los reembolsos aprobados por el App Store de un cliente, 20 por página, y Apple lo sugiere para recuperar notificaciones de reembolso perdidas durante una caída.
¿Y los contracargos?
Los clientes pueden pedir un reembolso al emisor de su tarjeta, pero en el App Store la disputa es entre el banco y Apple. No recibirás solicitudes de pruebas de disputa y no hay nada que enviar. Lo que verás es el resultado: un REFUND si el dinero se devolvió, y REFUND_REVERSED si Apple revirtió un reembolso tras una disputa del cliente.
Así que el «trabajo de contracargos» de una app iOS es sobre todo prevención y detección:
- Haz que la vía de reembolso dentro de tu app sea fácil de encontrar (la hoja
beginRefundRequest), para que los clientes descontentos la usen en lugar de ir a su banco. - Responde a tiempo a cada consumption request que puedas responder.
- Asocia los reembolsos a las cuentas. La guía de Apple sugiere asociar las notificaciones
REFUNDa tus cuentas de usuario para «identificar compras reembolsadas repetidas» y actividad sospechosa.
Errores habituales
- Enviar datos sin consentimiento. La API lo rechaza y rompe las reglas de Apple.
- Perder la ventana de 12 horas. Procesa
CONSUMPTION_REQUESTen una cola con alerta, no en un lote nocturno. - Enviar siempre
DECLINE. Tu preferencia es solo un factor, y declarar un uso que no puedes respaldar no ayuda. - No revocar tras un reembolso, o no restablecer tras una reversión.
- Ningún vínculo entre las transacciones de Apple y tus usuarios. Sin
appAccountTokenno puedes medir el consumo, y no puedes responder.
Hacerlo con NoChurn
NoChurn lee tus App Store Server Notifications, así que las solicitudes de reembolso, los reembolsos, los rechazos y las reversiones aparecen en la cronología de cada cliente con el motivo que dio Apple. Cuando Apple envía una consumption request para un cliente que dio su consentimiento, NoChurn puede responderla con el uso real de ese cliente a partir de tus datos, dentro de la ventana de Apple. Los reembolsos también alimentan el churn score. Apple se queda con el pago, la decisión de reembolso y todo lo que implica al banco del cliente; NoChurn nunca finge lo contrario. La configuración y los límites están en NoChurn + App Store.