Event traces
Query audit records for payment, subscription, product, price, and customer activity.
Event traces provide an audit trail for activity in PayNowPro. Use them to investigate a specific event, follow related activity through a trace, or list activity by time period, event type, or executor.
Trace data
An event-trace record contains:
| Field | Meaning |
|---|---|
traceId | Links related events in the same trace. |
eventId | Identifies one event in the trace. |
parentId | Identifies a parent event when the event is part of a chain. |
isRoot | Indicates whether the event starts the trace. |
activityType | Describes the activity that produced the record. |
executorId | Identifies the user or system that performed the action. |
payload | Event-specific data. Handle it as operational data and avoid exposing sensitive values. |
createdAt | ISO timestamp for the event. |
Supported activity types
The trace service records these event types:
PaymentEventSubscriptionCreationEventSubscriptionCancellationEventSubscriptionDeletionEventSubscriptionScheduledChangeEventRecurringPaymentCancellationEventProductDeletionEventProductExpiryEventPriceDeletionEventPriceUpdateEventCustomerDeletionEvent
Query traces
You can query activity by:
- Time frame, with a required start date and optional end date.
- Activity type.
- Executor ID.
- Trace ID, timestamp, and event ID for one event.
- Trace ID for all events in a trace.
List queries support limit, cursor, and order parameters. Use the returned nextCursor unchanged to request the next page.
curl "https://api.paynowpro.com/api/v1/traces/timeframe?tenantAlias=YOUR_TENANT_ALIAS&startDate=2026-01-01&endDate=2026-01-31&limit=100" \
-H "api-key: YOUR_API_KEY"Send dates in YYYY-MM-DD format. See the Traces API reference for all available query parameters.