Reward Audit Trail
Every reward action — point award, badge grant, tier promotion, deduction, rejection, or expiry — is recorded in an immutable audit trail. The audit trail provides complete accountability for the rewards system, enabling retrospective review and compliance verification.
Audit Log Fields
| Field | Description |
|---|---|
event_id | Unique identifier for this audit log entry |
event_type | Type of action: PointAward, PointDeduction, BadgeGrant, BadgeRevoke, TierPromotion, TierDemotion, Rejection, Expiry |
publisher_id | ID of the publisher who received (or was the subject of) the action |
publisher_name | Display name at the time of the event |
amount | Points awarded or deducted (for point events); badge name (for badge events); tier name (for tier events) |
reason | The reason note provided by the submitting admin |
submitted_by | Admin account ID and name who initiated the action |
submitted_at | UTC timestamp of when the action was submitted |
approved_by | Admin account ID and name who approved (null for immediate actions) |
approved_at | UTC timestamp of approval (null for immediate actions) |
status | Applied, Pending, Rejected, Expired |
batch_id | Batch reference ID (populated for bulk award entries; null for manual awards) |
Accessing the Audit Trail
The reward audit trail is accessible at Rewards Management → Audit Trail. The audit log is paginated, showing 50 entries per page by default. All admin accounts can view the full audit trail.
Filtering and Searching
| Filter | Options |
|---|---|
| Date range | Last 7 days / Last 30 days / Last 90 days / Custom range |
| Event type | All / Point Awards / Point Deductions / Badge Grants / Tier Promotions / Rejections |
| Publisher | Search by publisher name or ID to see all reward events for a specific publisher |
| Admin | Filter by submitting admin or approving admin to see all actions by a specific admin |
| Status | All / Applied / Pending / Rejected / Expired |
| Batch | Enter a batch ID to see all entries from a specific bulk award batch |
Immutability
The audit trail is append-only — entries cannot be edited or deleted. If an award is reversed (deducted), a new entry is added for the deduction. The original award entry remains unchanged in the log. This ensures the complete history of every action is permanently preserved, even if subsequent actions modified the outcome.
If there is ever a dispute about whether a reward was issued, what amount was awarded, or who authorized it, the audit trail is the authoritative record. All entries include the exact UTC timestamp, the admin identities on both sides of any dual-approval, and the full reason note as it was entered at the time of the action.
Exporting the Audit Trail
The audit trail can be exported to CSV for external reporting or compliance review. The export respects whatever filters are currently applied — to export only point awards in a date range, apply those filters before exporting. The CSV includes all fields from the audit log in the same format as the on-screen display.
Publisher View of Their Reward History
Publishers see a simplified version of their reward history in the Publisher Dashboard → Reputation → Event Log. This shows every point event — both automatic (installs, reviews, certifications) and admin awards — with the amount, date, and reason note. Publishers see only their own events; they cannot see the full marketplace audit trail.