Payment Order and Related Entities

This diagram illustrates the relationships between a Payment Order and other related entities, including Refund Orders, Dispute Records, and Settlement Details. It highlights how a Payment Order is processed and tracked throughout the payment system.

Payment Order

A Payment Order represents a single payment transaction initiated by a customer. It serves as the core record of payment information, tying together crucial data such as the payment amount, method (e.g., card, PayPal, wallet), and transaction timing. Each Payment Order can be linked to one or more Refund Orders (in the event of partial or multiple refunds) and may also have associated Dispute Records (for chargebacks or claims). By keeping these details centralized in a Payment Order, the system can easily track and reconcile every stage of the payment lifecycle.

Settlement Batch

A Settlement Batch is a collection of Settlement Details grouped together for a specific settlement process or time period. It provides a summarized view of various transaction records—such as payments, refunds, and adjustments—allowing the system to reconcile all related financial activities under a single batch. This structure simplifies tracking, reporting, and consolidating payments, making it easier to manage payouts and ensure accurate settlements across multiple orders.

Payout Order

A Payout Order represents the overall process of distributing or settling funds for a collection of completed transactions. It consolidates multiple Settlement Batches—each containing its own detailed records (for payments, refunds, etc.)—into a single, higher-level structure. By grouping all these financial flows together, the Payout Order provides a clear snapshot of total payouts due, along with an organized framework for auditing and reconciling payment activities across multiple transactions.

Settlement Details

A Settlement Detail is an individual record that captures the financial specifics of a single transaction (e.g., payment, refund, chargeback, or adjustment). Each detail references exactly one transaction source—such as a Payment Order or Refund Order—and includes data like the amount, currency, and timestamps. By grouping these entries under a Settlement Batch, the system can easily track and reconcile all the financial activities related to a payout or settlement period.