Payment Reconciliation

Payment reconciliation ties every transaction from order to bank deposit — fees, payouts, disputes and exceptions — so that what the merchant sold, what the processor settled and what the bank posted all agree. This page lists the 59 data points Athia uses for this use case, with the definition, type, expected source and availability of each.

The field names below are the payments-standard names for each data point. Use this page as a mapping aid: line up each field against its equivalent in your order, PSP, acquirer and bank data, and note where a name, format or grain differs.

📘

The field names on this page are payments-standard names — they describe each data point at the level of the standard it comes from. Athia Data Dictionary carries the names Athia uses and a crosswalk between the two. You do not have to match either exactly — the mapping from your own columns is agreed with your Athia team on ingest. One delivered field often covers several data points here, decline codes especially.

Sub-use cases

  • 3-way reconciliation — Matching the order record, the PSP/acquirer record and the bank posting on shared identifiers — order and gateway transaction IDs, auth code, ARN, RRN, STAN, settlement ID, bank transaction ID — and reconciling the amounts and timestamps across the three.
  • ERP cash-application — Applying bank receipts back to invoices and orders using invoice ID, merchant reference, bank reference, remittance information and the posted amount.
  • Tax & tip — Explaining differences between the order total and the amount actually captured, using order amount against capture amount.
  • FX / cross-border — Reconciling presentment amount and currency against settlement amount and currency, including the applied rate, its source, FX markup in basis points, DCC flag and cross-border fee.
  • Multi-PSP / multi-acquirer — Normalising records across processors and acquirers using gateway transaction ID, MID, TID and raw processor response codes.
  • Network reports — Reconciling network-level lines — interchange amount, scheme fee, settlement ID and ARN — against acquirer settlement files.
  • Chargebacks & refunds — Tracking dispute cases end to end: case ID, reason code, chargeback cycle, response deadline and representment outcome, plus refunds and the settlement they land in.
  • Reserves — Following amounts held back and released, using batch and settlement IDs, settlement date, gross and net settlement amounts, posted amount and payout ID.
  • Fee reconciliation — Verifying charged fees line by line — interchange program code and rate, scheme fee code and amount, cross-border fee and FX markup — against gross and net settlement amounts.
  • ISO 20022 bank layer — Working with structured bank message fields: value date, end-to-end ID, instruction ID, transaction ID and remittance information.
  • Marketplace payouts — Tracing funds out to sub-merchants or sellers via the payout identifier.
  • Exception management — Handling breaks that do not reconcile: exception type, aging in days, monetary impact and resolution code.

Data points

All 59 fields, grouped by category.

Order layer

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
order_idOrder layerMerchant order/cart identifier.stringORD-10293Merchant / ERP integrationFullNone
order_amountOrder layerOrder total in order currency.money12999 USDMerchant / ERP integrationFullNone
order_currencyOrder layerCurrency the order was placed in.codeUSDMerchant / ERP integrationFullNone
order_timestampOrder layerWhen the order was created.timestamp2026-05-18T10:11ZMerchant / ERP integrationFullNone
customer_idOrder layerCustomer who placed the order.uuidcus_4f0…Merchant / ERP integrationFullPII
invoice_idOrder layerInvoice tied to the order (ERP).stringINV-55821Merchant / ERP integrationFullNone

Gateway / PSP

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
gateway_txn_idGateway / PSPPSP/gateway transaction identifier.stringpi_3Nf…PSP / processor reportFullNone
merchant_referenceGateway / PSPMerchant reference passed to the PSP.stringORD-10293PSP / processor reportFullNone
auth_codeGateway / PSPIssuer approval code at authorization.stringA1B2C3PSP / processor reportFullNone
auth_timestampGateway / PSPTime of authorization.timestamp2026-05-18T10:12ZPSP / processor reportFullNone
capture_idGateway / PSPIdentifier of the capture event.stringcap_77a…PSP / processor reportFullNone
capture_amountGateway / PSPAmount captured (may differ from auth).money12999 USDPSP / processor reportFullNone
midGateway / PSPMerchant ID at the acquirer/PSP.stringMID_88213PSP / processor reportFullNone
tidGateway / PSPTerminal ID where applicable.stringTID_004PSP / processor reportPartialNone
processor_response_codeGateway / PSPRaw response code from the processor.code00PSP / processor reportFullNone

Acquirer settlement

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
arnAcquirer settlementAcquirer Reference Number tracing the txn.string7491…0231Acquirer / network fileFullNone
rrnAcquirer settlementRetrieval Reference Number.string615012345678Acquirer / network fileFullNone
stanAcquirer settlementSystem Trace Audit Number.integer045128Acquirer / network fileFullNone
batch_idAcquirer settlementSettlement batch the txn belongs to.stringBATCH-0521Acquirer / network fileFullNone
settlement_idAcquirer settlementIdentifier of the settlement record.stringSTL-99213Acquirer / network fileFullNone
settlement_dateAcquirer settlementDate funds settled to the acquirer.date2026-05-20Acquirer / network fileFullNone
gross_settlement_amountAcquirer settlementSettlement amount before fees.money12999 USDAcquirer / network fileFullNone
net_settlement_amountAcquirer settlementSettlement amount net of fees.money12674 USDAcquirer / network fileFullNone
interchange_amountAcquirer settlementInterchange fee charged on the txn.money260 USDAcquirer / network fileFullNone
scheme_feeAcquirer settlementNetwork/scheme fee charged.money25 USDAcquirer / network fileFullNone

Bank layer

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
bank_txn_idBank layerBank transaction identifier for the deposit.stringBNK-71820Acquirer / network fileFullNone
bank_referenceBank layerRemittance reference on the bank credit.stringSTL-99213Acquirer / network fileFullNone
value_dateBank layerValue date the funds posted.date2026-05-22Acquirer / network fileFullNone
posted_amountBank layerAmount actually credited to the bank account.money12674 USDAcquirer / network fileFullNone
payout_idBank layerIdentifier of the payout/deposit.stringPO-44021Acquirer / network fileFullNone
end_to_end_idBank layerISO 20022 end-to-end reference.stringE2E-99213Acquirer / network fileFullNone
instr_idBank layerISO 20022 instruction identifier.stringINSTR-771Acquirer / network fileFullNone
tx_idBank layerISO 20022 transaction identifier.stringTX-99213Acquirer / network fileFullNone
rmt_infBank layerISO 20022 remittance information (free text).stringInv INV-55821Acquirer / network fileFullNone

Fee detail

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
interchange_program_codeFee detailInterchange program/tier qualified for.codeCPS/RetailAcquirer / network fileFullNone
interchange_rate_bpsFee detailInterchange rate in basis points.decimal175Acquirer / network fileFullNone
scheme_fee_codeFee detailCode of the specific scheme fee.codeNABUAcquirer / network fileFullNone
scheme_fee_amountFee detailAmount of the scheme fee.money0.0195 USDAcquirer / network fileFullNone
cross_border_feeFee detailCross-border assessment fee.money1.30 USDAcquirer / network fileFullNone
fx_markupFee detailFX markup amount applied.money0.90 USDAcquirer / network fileFullNone

FX detail

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
presentment_amountFX detailAmount in the cardholder's presentment currency.money12999 USDAcquirer / network fileFullNone
presentment_currencyFX detailCardholder presentment currency.codeUSDAcquirer / network fileFullNone
settlement_amountFX detailAmount in settlement currency.money11950 EURAcquirer / network fileFullNone
settlement_currencyFX detailCurrency funds settled in.codeEURAcquirer / network fileFullNone
fx_rate_appliedFX detailFX rate used for conversion.decimal0.9193Acquirer / network fileFullNone
fx_rate_sourceFX detailSource/benchmark of the FX rate.enumVisa rateAcquirer / network fileFullNone
fx_markup_bpsFX detailFX markup over the benchmark in bps.decimal75Athia derivedFullNone
dcc_flagFX detailWhether Dynamic Currency Conversion was used.booleanfalseAcquirer / network filePartialNone

Disputes & refunds

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
chargeback_case_idDisputes & refundsIdentifier of the dispute case.stringCB-3321Acquirer / network fileFullNone
reason_codeDisputes & refundsDispute reason code.codeVisa 10.4Acquirer / network fileFullNone
chargeback_cycleDisputes & refundsStage of the dispute (CB1/CB2/REP/ARB).enumREPAcquirer / network fileFullNone
respond_by_dateDisputes & refundsDeadline to respond to the dispute.date2026-06-05Acquirer / network fileFullNone
representment_outcomeDisputes & refundsOutcome of representment.enumwonAcquirer / network fileFullNone
refund_idDisputes & refundsIdentifier of a refund.stringre_8d2…PSP / processor reportFullNone
refund_settlement_idDisputes & refundsSettlement record for the refund debit.stringSTL-99250Acquirer / network fileFullNone

Exceptions

FieldCategoryDefinitionTypeExampleSourceAvailabilityData class
exception_typeExceptionsClass of reconciliation break.enumAMOUNT_MISMATCHAthia derivedFullNone
aging_daysExceptionsDays the exception has been open.integer3Athia derivedFullNone
monetary_impactExceptionsValue at risk for the exception.money49 USDAthia derivedFullNone
resolution_codeExceptionsHow the exception was resolved.enumfee_adjustmentAthia derivedFullNone

Availability

Availability describes how reliably Athia can obtain a field in practice, not how important it is. A field marked Partial is still worth mapping — it simply will not be present for every provider or every transaction.

ValueWhat it means
FullAthia gets this reliably from standard sources.
PartialAvailable from some providers, or some of the time.
LimitedAvailable only in specific setups or on request.
Not availableAthia cannot obtain this today.

For payment reconciliation, no field is marked Not available — every data point on this page is obtainable. Two are Partial: tid, which only applies where terminals are involved, and dcc_flag, which depends on the provider reporting dynamic currency conversion. Where either is absent, terminal-level and DCC-specific breakdowns are correspondingly incomplete.

Data class

PCI fields are minimised: BIN plus last four only, never a full PAN and never a CVV value. PII should be delivered hashed, tokenized or generalized wherever the analysis allows it — in this use case customer_id is the only field carrying PII, and a stable pseudonymous identifier is sufficient. Sensitive fields are never required.

Field-level definitions for the core entities are in Athia Data Dictionary.


Did this page help you?