Monitoring Refund Events
Every refund-related notification that RefundShield processes, from the App Store or Google Play, is logged and visible in your app's Events tab. Here's how to read and use the events log.
Event Types
Each event has one of the following statuses:
| Status | What It Means |
|---|---|
| RESPONSE SENT | The store asked for a refund decision. RefundShield responded automatically. |
| REFUND DECLINED | The store denied the customer's refund request. Your revenue is protected. |
| REFUNDED | The store approved the refund. This can happen even if a decline preference was sent. |
| LIMIT REACHED | Your monthly plan limit was reached. No response was sent to the store, the refund was likely granted. |
On Apple, the final outcome (REFUNDED / REFUND DECLINED) arrives via a follow-up notification, usually within 1–2 days after RefundShield responds to the request. On Google Play there is no second notification: RefundShield polls the order status for up to 7 days. If Google does not communicate a final outcome within that window, the refund is automatically considered declined.
Event Details
Click on any event to expand the full details. Each event shows:
- Purchase Date: when the original transaction was completed
- Transaction: the store's transaction identifier for this purchase (Apple transaction ID or Google order ID)
- Original Transaction: the root transaction ID, useful for identifying a subscription across renewals
- Product: the in-app purchase or subscription product ID (e.g.,
com.example.monthly) - Price: the amount charged in the local currency, with an approximate USD conversion
- Country: the storefront country code where the purchase was made
- Customer: your customer UUID, if correctly set up in your app
Context
Each event includes a collapsible Context section with the data RefundShield used to evaluate the request:
- Days Since Purchase: how many days elapsed between the transaction's purchase date and the refund request
- Renewals: number of times the subscription renewed before the refund request
- Used Free Trial: whether the customer consumed a free trial period for this product
- Strategy Applied: the protection preset active on the app at the time of the event (Maximum, Medium, or Minimum)
Filtering Events
The Events table has three filters you can combine:
- Search: free-text search by transaction ID or product ID
- Reason: filter by the refund reason the store reported (e.g., on Apple: Unintended purchase, Fulfillment issue, Unsatisfied with purchase, Legal, or Other)
- Status: filter by outcome: Response sent, Refund declined, Refunded, or Limit reached