Your Payments Processing Data Template

Universal process mining template
Your Payments Processing Data Template

Your Payments Processing Data Template

Universal process mining template

This is our generic process mining data template for Payments Processing. Use our system-specific templates for more specific guidance.

Select a specific system
  • Comprehensive field definitions for transaction tracking
  • Universal activity mapping for payment lifecycles
  • Scalable data structures compatible with any financial system
New to event logs? Learn how to create a process mining event log.

Payments Processing Attributes

Explore the recommended data fields to include in your event log, which are designed to provide the deep context necessary for a comprehensive analysis of your financial processes.
5 Required 6 Recommended 3 Optional
Name Description
Activity Name
ActivityName
The specific step, status change, or event that occurred in the payment lifecycle.
Description

This attribute describes the action taken or the state change that the payment has undergone at a specific point in time. Examples include the creation of the request, validation checks, authorization steps, or final settlement.

Process mining relies on this attribute to define the nodes in the process map. By analyzing the sequence of these activities, analysts can identify common variants, loops where payments are reworked, and bottlenecks where payments sit for extended periods.

Standardizing these names across different source systems is often necessary to create a coherent view of the process. For example, one system might call a step 'Auth' while another calls it 'Authorization', and these should be aligned during data transformation.

Why it matters

It defines the nodes in the process map and allows for the analysis of process flow and variants.

Where to get

Found in audit logs, status history tables, or event tracking tables.

Examples
Payment CreatedPayment AuthorizedPayment FailedSettlement ConfirmedValidation Error
Event Timestamp
EventTimestamp
The specific date and time when the activity or status change occurred.
Description

This attribute records the exact moment an event took place within the payment system. It acts as the chronological anchor for the process, ensuring that events are ordered correctly within the case.

In analysis, this timestamp is the basis for all time-based calculations. It is used to determine the duration between activities, the total end-to-end cycle time, and adherence to service level agreements. Accurate timestamps are vital for identifying when bottlenecks occur.

High precision is preferred, especially for high-frequency trading or automated payment systems where milliseconds matter. If only dates are available without times, the ordering of activities that happen on the same day may require secondary sorting logic.

Why it matters

Essential for ordering events and calculating all duration-based KPIs like Cycle Time.

Where to get

Found in transaction logs, history tables, or system audit trails.

Examples
2023-10-15T08:30:00Z2023-10-15 14:45:12.5502023-11-01T09:00:00+00:0010/15/2023 08:30:00 PM2023-10-16 10:15:00
Last Data Update
LastDataUpdate
The timestamp indicating when the record was last extracted or refreshed.
Description

This attribute tracks the freshness of the data used in the analysis. It reflects the time when the data was loaded into the process mining tool or when the record was last modified in the source database.

Having this information is vital for data governance and trust. It allows analysts to know if they are looking at real-time data or a snapshot from the previous day. This is particularly important for monitoring active payments that may be stuck in a pending state.

While not used directly for process flow calculations, it serves as a metadata control field to ensure that dashboards are displaying the most current status of the payment operations.

Why it matters

Ensures data freshness and helps in debugging data pipeline latency issues.

Where to get

Generated during the data extraction or ETL process.

Examples
2023-10-27T12:00:00Z2023-10-27 23:59:592023-10-28 06:00:0010/27/20232023-11-01 01:00:00.000
Payment Transaction ID
PaymentTransactionId
The unique identifier representing the specific payment instruction or transaction case.
Description

This attribute serves as the central key for linking all activities within a single payment lifecycle. It allows process mining tools to reconstruct the end-to-end journey of a payment from initiation to final settlement or failure.

In analysis, this identifier is used to group distinct events into a single case instance. It enables the visualization of the process flow and is critical for calculating cycle times per transaction. Without a unique ID, it is impossible to distinguish between thousands of simultaneous payments moving through the system.

This field typically remains constant throughout the lifespan of the payment. However, in complex scenarios involving multiple systems, this may need to be a composite key or mapped from a unique end-to-end reference number.

Why it matters

It is the fundamental Case ID required to create a process model and track specific payments.

Where to get

Typically found in the transaction header, payment instruction table, or main ledger log.

Examples
TRX-8859201PAY-2023-X9910029384f47ac10b-58cc-4372-a567-0e02b2c3d479INSTR-5542
Source System
SourceSystem
The name of the application or system where the event data originated.
Description

This attribute identifies the technical origin of the record. In end-to-end payment processes, data often flows through multiple systems, such as a front-end gateway, a fraud detection engine, and a back-end ledger.

Analyzing data by system allows users to isolate technical issues. For instance, if delays are consistently observed in the fraud engine but not the ledger, the root cause analysis can be targeted effectively. It also helps in validating data integrity when merging multiple data sources.

This field is typically added during the extraction and transformation process if it does not explicitly exist in the source data. It serves as a lineage marker for auditing and debugging purposes.

Why it matters

Crucial for multi-system analysis and identifying which component is causing delays or errors.

Where to get

Often hardcoded during the ETL process or found in system metadata.

Examples
PaymentGateway_01CoreBankingSystemFraudEngineSwiftInterfaceERP_SAP
Currency Code
CurrencyCode
The 3-letter ISO code denoting the currency of the payment.
Description

This attribute specifies the currency unit for the payment amount, such as USD, EUR, or GBP. It is critical for accurate financial reporting and for triggering specific cross-border workflows.

Analysis often requires filtering by currency to understand regional performance or FX processing times. Different currencies may have different cut-off times, settlement cycles, and regulatory requirements, which directly influence the process flow.

Without this attribute, the 'Payment Amount' field is ambiguous. This field enables the conversion of disparate amounts into a single reporting currency for global dashboarding.

Why it matters

Necessary for normalizing financial values and identifying cross-border process variations.

Where to get

Found alongside the payment amount in transaction tables.

Examples
USDEURGBPJPYCAD
Error Code
ErrorCode
The specific code or reason generated when a payment fails or is rejected.
Description

This attribute captures the technical or business reason for a process failure. It is populated when a payment is rejected, fails validation, or encounters a transmission error.

Analyzing error codes is the primary method for reducing the 'Payment Failure Rate' and 'Rework Rate'. Grouping common error codes helps identify systemic issues, such as master data inaccuracies or technical connectivity problems with external clearing houses.

In happy path scenarios, this field is usually null. Its presence often indicates a deviation from the ideal process flow and triggers exception handling sub-processes.

Why it matters

The primary attribute for Root Cause Analysis of failures and rework.

Where to get

Found in error logs, rejection messages, or response payloads.

Examples
INSUFFICIENT_FUNDSINVALID_ACCOUNTFRAUD_SUSPICIONTIMEOUTDUPLICATE_REF
Payment Amount
PaymentAmount
The monetary value associated with the payment transaction.
Description

This attribute represents the financial value that is being transferred. It is the primary numeric metric for sizing the impact of process inefficiencies. For example, a delay in a million-dollar payment is often more critical than a delay in a ten-dollar payment.

In analysis, this field is used to aggregate volumes, calculate total liquidity requirements, and segment payments by value bands. High-value payments often follow different approval workflows compared to low-value ones, and this attribute helps differentiate those paths.

It is essential to pair this attribute with the currency code to ensure apples-to-apples comparisons. Aggregating amounts without currency conversion or separation can lead to misleading financial reporting.

Why it matters

Allows for financial impact analysis and segmentation of high-value vs low-value transactions.

Where to get

Found in the transaction details or financial posting tables.

Examples
150.0010000.5025.995000000.01
Payment Due Date
PaymentDueDate
The date by which the payment is expected or required to be settled.
Description

This attribute represents the target deadline for the payment. It allows the system to measure 'On-Time Payment Rate' and determining if service level agreements (SLAs) were met.

Comparing the actual completion timestamp against this due date provides a clear metric for process performance. Payments completed after this date are considered late, which may incur penalties or damage business relationships.

This field is particularly relevant for accounts payable processes or guaranteed service delivery contracts where timing is a contractual obligation.

Why it matters

Required for calculating SLA adherence and On-Time Payment rates.

Where to get

Found in the invoice header or payment request instruction.

Examples
2023-10-302023-11-012023-10-152023-12-312024-01-01
Payment Method
PaymentMethod
The specific instrument or mechanism used to execute the payment.
Description

This attribute categorizes the payment by its execution type, such as Wire Transfer, ACH, Credit Card, or Instant Payment. Each method typically follows a distinct process path with different timing expectations and costs.

By segmenting data using this attribute, analysts can compare the performance of different payment rails. For instance, wire transfers might require more manual approval steps compared to automated ACH batches.

Understanding the mix of payment methods helps in capacity planning and identifying shifts in customer behavior, such as a migration from traditional checks to digital instant payments.

Why it matters

Critical for distinguishing between process variants (e.g., Instant vs Wire) which have different SLAs.

Where to get

Found in the payment instruction details.

Examples
WireACHCredit CardSEPA Credit TransferReal-Time Payment
Processing User
ProcessingUser
The user ID or system agent responsible for performing the activity.
Description

This attribute identifies who or what executed a specific step in the payment process. It can refer to a human user performing a manual review, or a system account executing an automated task.

This data is vital for analyzing resource utilization and bottlenecks. It helps distinguish between automated processing (Straight-Through Processing) and manual interventions. High rates of manual user involvement often correlate with higher costs and slower cycle times.

For compliance, this field helps in segregation of duties analysis, ensuring that the person who created a payment is not the same person who approved it.

Why it matters

Enables analysis of automation rates (STP) and resource productivity.

Where to get

Found in audit logs or metadata columns of the transaction table.

Examples
SystemAgent_01jdoeAPPROVER_GROUP_AAutoReconcilerAPI_User
Beneficiary Name
BeneficiaryName
The name of the entity or individual receiving the payment.
Description

This attribute identifies the payee. In a B2B context, this is the vendor; in a P2P context, it is the individual recipient. It provides context for who is being paid.

Analyzing payments by beneficiary can reveal patterns such as frequent payments to high-risk entities or concentration risk with specific vendors. It is also useful for fraud analysis, identifying if multiple small payments are being funneled to a single unexpected beneficiary.

Data quality issues are common here, with variations in spelling (e.g., 'Inc.' vs 'Incorporated'). Cleaning this data is often necessary for accurate aggregation.

Why it matters

Useful for vendor analysis, fraud detection, and risk profiling.

Where to get

Found in the beneficiary details section of the payment instruction.

Examples
Acme CorpGlobal Services LtdJohn SmithAzure Cloud ServicesTax Authority
Processing Channel
ProcessingChannel
The interface or channel through which the payment was initiated.
Description

This attribute indicates the entry point of the payment instruction, such as Mobile App, Web Portal, API, or File Upload. It provides insight into customer behavior and channel usage.

Analyzing process performance by channel can highlight technical disparities. For example, payments initiated via API might be processed instantly, while file uploads might wait for batch processing windows. This helps in understanding the user experience across different platforms.

It is also useful for analyzing the shift from legacy channels (like manual entry or fax) to digital channels, supporting digital transformation initiatives.

Why it matters

Helps analyze volume trends and performance differences across entry points (e.g., Mobile vs Web).

Where to get

Found in the transaction header or session metadata.

Examples
Mobile AppWeb PortalH2H FileAPIPOS Terminal
Risk Score
RiskScore
A numerical score indicating the likelihood of fraud or compliance risk.
Description

This attribute is a value generated by fraud detection engines or risk models. A higher score typically indicates a higher probability that the transaction is fraudulent or high-risk.

In process analysis, this score helps explain why certain payments go through extended review loops. Payments with high risk scores often trigger manual intervention activities, increasing the cycle time. Correlating risk scores with final outcomes (approved vs rejected) helps tune the efficiency of the risk rules.

Not all systems generate a numeric score; some may only provide a status flag. However, for modern payment gateways, this is a standard metric for decisioning.

Why it matters

Explains process deviations such as manual reviews and holds due to fraud checks.

Where to get

Output from the fraud detection system or risk engine.

Examples
08512.5994
Required Recommended Optional

Payments Processing Activities

Capture these key process steps and milestones to ensure your event log provides an accurate foundation for process discovery and detailed performance monitoring.
6 Recommended 8 Optional
Activity Description
Payment Approved
The internal milestone where an authorized user or system rule grants permission for the payment to proceed. This is distinct from external financial authorization and represents organizational sign-off.
Why it matters

Often a major source of bottlenecks due to manual workflows and human latency.

Where to get

Recorded in workflow approval logs or when the approval flag is set to true.

Capture

Log the timestamp when the final approval action is committed to the database.

Event type explicit
Payment Authorized
The financial confirmation that funds are reserved or available for the transaction. This is often an interaction with a banking core, card issuer, or credit facility.
Why it matters

Confirming authorization is a key control point before funds are actually moved.

Where to get

Found in gateway response logs or core banking system authorization tables.

Capture

Extract the timestamp of the positive authorization response code.

Event type explicit
Payment Created
The initial creation of a payment transaction record within the system. This event captures the timestamp when the payment request is first logged, whether manually entered by a user or generated via an API call.
Why it matters

Establishes the start time for the end-to-end payment cycle and serves as the baseline for volume analysis.

Where to get

Typically found in the main transaction table creation timestamp or a dedicated audit log entry for new records.

Capture

Extract the earliest timestamp associated with the Payment Transaction ID.

Event type explicit
Payment Failed
A terminal status indicating the payment could not be completed due to unrecoverable technical or financial issues. This represents a definitive end to the process instance.
Why it matters

A key metric for reliability; analyzing patterns here helps reduce transaction drop-off.

Where to get

Captured from final failure status codes or fatal error logs.

Capture

Identify transactions entering a terminal failure state.

Event type explicit
Payment Instruction Sent
The transmission of the finalized payment file or message to the external payment network or clearing house. This marks the handoff from the internal system to the external world.
Why it matters

This is a critical milestone separating internal processing time from external settlement time.

Where to get

Logged when files are generated, API calls are sent to the network, or status changes to Transmitted.

Capture

Identify the timestamp of the outgoing API call or file transfer event.

Event type explicit
Payment Settled
The successful completion of the financial movement, where funds are credited to the beneficiary. This is the primary successful end state for a payment transaction.
Why it matters

Used to calculate the full cycle time and is the primary success criteria for the process.

Where to get

Usually indicated by a specific settlement status, a confirmation report, or a general ledger posting.

Capture

Extract the date and time when the settlement confirmation is processed.

Event type explicit
Payment Cancelled
The deliberate termination of a payment by a user or administrator before it has been settled. This effectively voids the transaction.
Why it matters

Differentiating cancellations from failures is important for understanding user behavior versus system errors.

Where to get

Explicitly logged when a cancel command is executed or status changes to Void.

Capture

Capture the timestamp of the cancellation command.

Event type explicit
Payment Confirmed
The receipt of a technical acknowledgement from the external network indicating the instruction was received and format-valid. This confirms the payment is in the external pipeline.
Why it matters

Verifies that the handoff to the network was successful and the transaction is pending settlement.

Where to get

captured from incoming acknowledgement messages (ACKs) or webhooks from the provider.

Capture

Log the receipt time of the external system's acknowledgement message.

Event type explicit
Payment Error Identified
Indicates that the system or an external validator has flagged an issue with the payment, such as insufficient funds or invalid data. This event marks the beginning of an exception handling loop.
Why it matters

Critical for calculating rework rates and identifying quality issues in the upstream data entry process.

Where to get

captured from error logs, exception tables, or status codes indicating failure or suspension.

Capture

Filter for error codes or status updates that flag the transaction for repair.

Event type explicit
Payment Error Resolved
Marks the correction of a previously identified issue, allowing the payment to return to the normal processing flow. This usually involves manual intervention or an automated retry mechanism.
Why it matters

Essential for measuring the time and effort spent on resolving payment exceptions.

Where to get

Inferred when a transaction moves from an error state back to a processing or ready state.

Capture

Detect status transitions from error codes back to valid processing statuses.

Event type inferred
Payment Reconciled
The accounting process where the payment system record is matched against bank statements or external ledgers. This ensures the system of record matches reality.
Why it matters

Indicates the administrative closure of the transaction and financial integrity.

Where to get

Found in reconciliation modules or inferred when a match ID is assigned to the transaction.

Capture

Link the transaction to the reconciliation table timestamp.

Event type calculated
Payment Refunded
Occurs when a settled payment is reversed, returning funds to the payer. This activity typically happens after the main process has nominally finished.
Why it matters

Refund rates are a key quality indicator for the underlying business service or product.

Where to get

Captured from a linked refund transaction or a status change indicating reversal.

Capture

Identify refund events linked to the original payment ID.

Event type explicit
Payment Rejected
The event where an internal approver or external gatekeeper explicitly denies the payment request. This stops the current flow and may trigger a notification to the initiator.
Why it matters

Important for analyzing rejection reasons and reducing noise in the payment pipeline.

Where to get

Explicitly logged in workflow history or inferred from a final status update like Rejected or Declined.

Capture

Capture the specific action where a user or system creates a rejection event.

Event type explicit
Payment Validated
The completion of automated checks on the payment instruction, such as format syntax, account number validity, and compliance screening. This step ensures the data is clean before it moves to approval or execution.
Why it matters

High duration here may indicate slow external validation services or complex compliance rules.

Where to get

Usually recorded when status changes from Draft to Validated or inferred from a validation success log.

Capture

Identify status changes indicating successful validation or specific log entries from a compliance engine.

Event type inferred
Recommended Optional

Extraction Guides

How to get your data for process mining.

Extraction methods vary by system. For detailed instructions,

read our ETL guide

or select a specific process and system.