Your Payments Processing Data Template
Your Payments Processing Data 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
Payments Processing Attributes
| 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 | |||
Payments Processing Activities
| 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 | |||
Extraction Guides
Extraction methods vary by system. For detailed instructions,