Use this page to find the right report fast — field counts, key fields, enumeration values, and the task-to-report selection matrix. For full field-by-field detail, sample values, and reconciliation workflows, go to the Field Schema Reference.

All reports at a glance

Multi-section field counts

The two multi-section reports carry a header, one or more content sections, and a footer, each with its own record-type prefix (the prefix is a section identifier, not a counted field):

• dispute-detail — RH (4 fields) + RD (46 fields) + RF (3 fields) = 53
• disbursement-fee — RH (4 fields) + RS (14 fields) + RD (60 fields) + RF (3 fields) = 81

Key fields by report

The fields most reconciliation work keys on. Full field lists are in the Field Schema Reference.

Field families

Fields recur across reports in a few consistent families.

Identity (all reports). Pid, Mid, ExternalMerchantIdentifier, Currency.

Transaction matching (detail reports). OrderId (FlexFactor internal ID), ExternalId (your order reference), EventTimestamp.

Amounts. Amount / ConsumerAmount (transaction value), TotalProcessedAmount (gross), SettlementAmount / DepositAmount / NetDisbursedAmount (net paid out).

Fees. ProcessingFees (aggregate), FlexFactorFee (per transaction), FeeType + FeeAmount (itemized in the fees report).

Reserve (settlement reports). ReserveAmount (held), ReserveReleaseAmount (released), ReserveUtilizationAmount (applied to cover losses).

Settlement identifiers. BatchId (batch UUID), CED (FlexFactor settlement tracking reference), TxnId (transaction ID from batch), SenderId / ReceiverId (financial account IDs, nullable).

Card data (PCI-compliant partial only). Bin (first 6 digits or N/A), Last4 (last 4 digits or N/A). Present in activity-detail, activity-exceptions, and settlement-detail.

Enumeration quick-reference

Complete definitions are in Data Formats & Enumerations.

Critical calculations

The derived amounts each report expects to balance to. Full derivations and workflows are in the Reconciliation Guide.

activity-summary:
  NetAmount = TotalProcessedAmount - ProcessingFees

settlement-summary:
  SettlementAmount = TotalProcessedAmount - ProcessingFees
                     - ReturnsAmount - ChargebacksAmount
                     - ReserveAmount + ReserveReleaseAmount
                     - ReserveUtilizationAmount + Adjustments

settlement-detail:
  DepositAmount = ConsumerAmount - ConsumerFee - FlexFactorFee

monthly-settlement-summary:
  NetSettlement = TotalSettledAmount - TotalFees

disbursement-fee (RS section):
  NetDisbursedAmount = Sales + Refunds + Disputes + Other + NetFees
  (Refunds, Disputes, and NetFees are negative values)

📘

Sign conventions differ by report family — flat-report aggregates are positive magnitudes (subtract), detail rows and the RS section are signed (sum). See the Reconciliation Guide.

Report selection matrix

Match a reconciliation task to its primary report and the reports that support it.