Simplified Format Transaction Export Data

Time	Status	User Agent
Retrieving recent requests…

The SimplifiedFormat export provides the same batch and transaction data as the standard Transactions export, but delivered in a consolidated XML structure that wraps all merchants under a single <Transactions> root element. It is designed for institutions that need core transaction and batch reconciliation data across their full merchant portfolio in a single file, without the full field depth of the standard Transactions export.

Endpoint

GET /download/YYYYMMDD/SimplifiedFormat

Authentication

Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Use this file when building a portfolio-level transaction reconciliation process where all merchants need to be processed together in a single pass. It is particularly useful for institutions with simpler integration requirements that do not need the full field set of the standard Transactions file. All amounts are in cents — divide by 100 to get dollar values.

Query Parameters

None. The file is identified by the date path segment (YYYYMMDD) and delivered via SFTP.

Response

200 OK — Returns XML content with the following structure:

XML Hierarchy: Transactions > Merchants > Merchant > Batches > Batch > Transactions > Transaction

<Merchant> fields:

Field	Type	Description
`MID`	string	Merchant identifier (unique account number)

<Batch> fields:

Field	Type	Description
`InternalId`	integer	Internal system identifier for the batch
`BatchId`	string	External batch identifier
`PointOfSaleOrInteractionTerminalIdentifier`	string	V-number: terminal ID where the batch originated
`BatchDate`	datetime	Date the batch was closed
`MerchantDepositDate`	datetime	Date funds are scheduled to be deposited to the merchant
`BatchNumber`	string	Sequential batch number for the processing period
`NetDepositAmount`	integer	Net deposit amount for the batch in cents
`TransactionsCount`	integer	Total number of transactions in the batch
`SalesAmount`	integer	Total sales volume in the batch in cents
`SalesCount`	integer	Number of sale transactions
`RefundAmount`	integer	Total refund amount in the batch in cents
`RefundCount`	integer	Number of refund transactions

<Transaction> fields:

Field	Type	Description
`CardType`	string	Card network: `V` = Visa, `M` = Mastercard, `S` = Amex, `D` = Discover, `R` = Discover (proprietary BIN)
`CardholderAccountNumber`	string	Masked card PAN (e.g. `414776******0555`)
`TransactionDate`	datetime	Date and time the transaction occurred
`TransactionAmount`	integer	Transaction amount in cents
`TerminalEntryMode`	string	Capture method: `01` = manual, `02` = magnetic stripe, `05` = chip/EMV, `07` = contactless
`AuthorizationCode`	string	Approval code from the card issuer
`AuthorizationSourceCode`	string	Source of authorization response (empty for Mastercard)
`CardholderIdentificationMethod`	string	Cardholder ID method: space = not specified, `1` = signature, `2` = PIN, `3` = unattended, `4` = MOTO
`AuthorizationCharacteristicsIndicator`	string	Interchange qualification indicator (`E`, `A`, `N`, etc.)
`PS2000TransactionIdentifier`	string	Unique network-level transaction reference identifier
`ValidationCode`	string	Interchange validation code (empty for Mastercard)
`TransactionCode`	string	Internal code classifying the transaction type
`AuthorizationResponseCode`	string	Issuer response code (`00` = approved; empty for some card types)
`TransactionFee`	integer	Fee applied to the transaction in cents; `xsi:nil="true"` if not applicable
`TransactionFeeIndicator`	string	Fee type indicator (empty if none)

<?xml version="1.0" encoding="utf-8"?>
<Transactions xmlns:xsd="http://www.w3.org/2001/XMLSchema"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Merchants>
    <Merchant>
      <MID>9180000000001234</MID>
      <Batches>
        <Batch>
          <InternalId>33797488</InternalId>
          <BatchId>00001247970</BatchId>
          <PointOfSaleOrInteractionTerminalIdentifier>79416045</PointOfSaleOrInteractionTerminalIdentifier>
          <BatchDate>2026-05-27T00:00:00</BatchDate>
          <MerchantDepositDate>2026-05-28T00:00:00</MerchantDepositDate>
          <BatchNumber>8436</BatchNumber>
          <NetDepositAmount>42657</NetDepositAmount>
          <TransactionsCount>3</TransactionsCount>
          <SalesAmount>42657</SalesAmount>
          <SalesCount>3</SalesCount>
          <RefundAmount>0</RefundAmount>
          <RefundCount>0</RefundCount>
          <Transactions>
            <Transaction>
              <CardType>V</CardType>
              <CardholderAccountNumber>414776******0555</CardholderAccountNumber>
              <TransactionDate>2026-05-27T14:22:00</TransactionDate>
              <TransactionAmount>14200</TransactionAmount>
              <TerminalEntryMode>07</TerminalEntryMode>
              <AuthorizationCode>014122</AuthorizationCode>
              <AuthorizationSourceCode>V</AuthorizationSourceCode>
              <CardholderIdentificationMethod>1</CardholderIdentificationMethod>
              <AuthorizationCharacteristicsIndicator>E</AuthorizationCharacteristicsIndicator>
              <PS2000TransactionIdentifier>346134553487245</PS2000TransactionIdentifier>
              <ValidationCode>ML6X</ValidationCode>
              <TransactionCode>0101</TransactionCode>
              <AuthorizationResponseCode>00</AuthorizationResponseCode>
              <TransactionFee>0</TransactionFee>
              <TransactionFeeIndicator />
            </Transaction>
            <Transaction>
              <CardType>M</CardType>
              <CardholderAccountNumber>536759******6473</CardholderAccountNumber>
              <TransactionDate>2026-05-27T15:10:00</TransactionDate>
              <TransactionAmount>18700</TransactionAmount>
              <TerminalEntryMode>05</TerminalEntryMode>
              <AuthorizationCode>072795</AuthorizationCode>
              <AuthorizationSourceCode />
              <CardholderIdentificationMethod>1</CardholderIdentificationMethod>
              <AuthorizationCharacteristicsIndicator>A</AuthorizationCharacteristicsIndicator>
              <PS2000TransactionIdentifier>MDJN4MFFJ</PS2000TransactionIdentifier>
              <ValidationCode />
              <TransactionCode>0101</TransactionCode>
              <AuthorizationResponseCode />
              <TransactionFee>0</TransactionFee>
              <TransactionFeeIndicator />
            </Transaction>
          </Transactions>
        </Batch>
      </Batches>
    </Merchant>
  </Merchants>
</Transactions>

Error Codes

Code	When it happens
400	Malformed date format in URL path
401	Invalid or missing Basic Auth credentials
403	User does not have permission for this operation
404	No SimplifiedFormat file found for the specified date
500	Internal server error

Common Mistakes

Expecting the same root element structure as the standard Transactions file — SimplifiedFormat wraps all merchants in <Transactions><Merchants>, not a per-merchant root.
Not dividing amounts by 100 — all amount fields (TransactionAmount, NetDepositAmount, SalesAmount, RefundAmount) are in cents.
Treating empty ValidationCode or AuthorizationResponseCode for Mastercard as errors — these fields are intentionally blank for Mastercard transactions.
Treating TransactionFee: xsi:nil="true" as zero — nil means no fee information is available, which is different from a zero-value fee.
Using CardType: S without knowing it represents Amex OptBlue (non-direct) and CardType: R as Discover proprietary BIN range (including Diner's Club).

Related Endpoints

GET /download/YYYYMMDD/Transactions — standard per-merchant transaction XML with more fields
GET /download/YYYYMMDD/TransactionsExtendedData — extended card type and network identifier data
GET /download/YYYYMMDD/TransAuth — authorization records for each transaction attempt

Example

curl -X GET "https://hq.staging.netevia.dev/download/20260528/SimplifiedFormat" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"