Litle & Co. Scheduled Secure Report Reference Guide. August Document Version: 1.8

Transcription

1 Litle & Co. Scheduled Secure Report Reference Guide August 2013 Document Version: 1.8

2 Litle & Co. Scheduled Secure Report Reference Guide Document Version: 1.8 All information whether text or graphics, contained in this manual is proprietary information of Litle & Co. and is provided to you solely for the purpose of assisting you in using a Litle & Co. product. All such information is protected by copyright laws and international treaties. The possession, viewing, or use of the information contained in this manual does not transfer any intellectual property rights or grant a license to use this information or any software application referred to herein for any purpose other than that for which it was provided. Information in this manual is presented as is and neither Litle & Co. or any other party assumes responsibility for typographical errors, technical errors, or other inaccuracies contained in this document. This manual is subject to change without notice and does not represent a commitment on the part of Litle & Co. or any other party. Litle & Co. does not warrant that the information contained herein is accurate or complete. All trademarks are the property of their respective owners and all parties herein have consented to their trademarks appearing in this manual. Any use by you of the trademarks included herein must have express written permission of the respective owner. Copyright , Litle & Co. ALL RIGHTS RESERVED.

3 About This Guide CONTENTS Intended Audience...v Revision History...v Document Structure... vii Documentation Set...ix Typographical Conventions...x Contact Information...xi Chapter 1 Introduction Available Reports... 2 Managing Report Subscriptions... 3 Retrieving Reports... 4 Microsoft Excel Limitations... 5 Chapter 2 Net Settled Sales by Transaction Report Filename Syntax... 8 Report Structure... 9 Chapter 3 Session Report Filename Syntax Report Structure Chapter 4 Transaction Summary Report Filename Syntax Report Structure Chapter 5 Activity and Settlement Reports Filename Syntax Report Structure Chapter 6 Chargeback Financial Report Filename Syntax Report Structure Chapter 7 Chargeback Status Report Filename Syntax Report Structure Document Version: 1.7 XML Release: X.X iii 2013 Litle & Co. Confidential and Proprietary. All Rights Reserved. Do not distribute without permission.

4 Contents Chapter 8 Fraud Alert Report Filename Syntax Report Structure Chapter 9 Customer Insights Report Filename Syntax Report Structure Chapter 10 Fee Report Filename Syntax Report Structure Chapter 11 Auto AU Repaired Auth Report Filename Syntax Report Structure iv Document Version: 1.7 XML Release: X.X 2013 Litle & Co. Confidential and Proprietary. All Rights Reserved. Do not distribute without permission.

5 ABOUT THIS GUIDE This manual serves as a reference to the format and contents of the reports generated and delivered via the Litle Scheduled Secure Report (SSR) system. Intended Audience This document is intended for technical personnel who will be retrieving and parsing reports generated by the SSR system. Revision History This document has been revised as follows: TABLE 1 Document Revision History Doc. Version Description Location(s) 1.0 First release new document N/A 1.1 Added Customer Insight Report chapter Added Fee report chapter 1.2 Added Chargeback Status report chapter Added Billing Descriptor column to NSS by Txn and Chargeback Financial reports 1.3 Added Issuing Bank Country Code field to the Chargeback Financial and Chargeback Status reports. Added Merchant Id field to NSS by Transaction, Chargeback Financial and Chargeback Status reports. Changed definition of existing Merchant Id field in session report. 1.4 Added Issuing Bank field to the Chargeback Financial and Chargeback Status reports. Chapter 8 Chapter 9 (New) Chapter 7 Chapters 2 and 6 Chapters 6 and 7 Chapters 2, 3, 6, and 7 Chapters 6 and 7 Document Version: 1.8 v

6 About This Guide Revision History TABLE 1 Document Revision History Doc. Version Description Location(s) 1.5 Added chapter for the AU Repaired Auth Report. Chapter Added section about the Manage Scheduled Reports interface. Added Vantiv logo to title page. 1.7 Added Refund Id column to Fraud Alert Report Added Merchant Name and Presenter Name columns to Fee Report 1.8 Corrected filename information for Fraud Alert report. Added Merchant Id field to Fee Report Added Presenter field to the Chargeback Financial and Chargeback Status reports. Chapter 1 Chapter 8 Chapter 10 Chapter 8 Chapter 10 Chapters 6 & 7 vi Document Version: 1.8

7 Document Structure About This Guide Document Structure This manual contains the following sections: Chapter 1, "Introduction" This chapter provides general information about Secure Scheduled reports and there retrieval. Chapter 2, "Net Settled Sales by Transaction Report" This chapter provides field definitions and information about the structure of the Net Settled Sales by Transaction report. Chapter 3, "Session Report" This chapter provides field definitions and information about the structure of the Session report. Chapter 4, "Transaction Summary Report" This chapter provides field definitions and information about the structure of the Transaction Summary report. Chapter 5, "Activity and Settlement Reports" This chapter provides field definitions and information about the structure of both the Activity and settlement reports. These are combined in a single chapter, because the structures are identical. Chapter 6, "Chargeback Financial Report" This chapter provides field definitions and information about the structure of the Chargeback Financial report. Chapter 7, "Chargeback Status Report" This chapter provides field definitions and information about the structure of the Chargeback Status report. Chapter 8, "Fraud Alert Report" This chapter provides field definitions and information about the structure of the Fraud Alert report. Chapter 9, "Customer Insights Report" This chapter provides field definitions and information about the structure of the Customer Insights report. Document Version: 1.8 vii

8 About This Guide Document Structure Chapter 10, "Fee Report" This chapter provides field definitions and information about the structure of the Fee report. Chapter 11, "Auto AU Repaired Auth Report" This chapter provides field definitions and information about the structure of the Automatic account Updater Repaired Auth report. viii Document Version: 1.8

9 Documentation Set About This Guide Documentation Set The Litle & Co. documentation set also includes the items listed below. Please refer to the appropriate guide for information concerning other Litle product offerings. Litle & Co. XML Reference Guide Litle & Co. User Interface Guide Litle & Co. Account Updater Implementation and Operations Guide Litle & Co. PayPal Integration Guide Litle & Co. Bill Me Later Integration Guide Litle & Co. Virtual Terminal User Guide Litle & Co. Chargeback XML and Support Documentation API Reference Guide Litle & Co. Chargeback Process Guide Litle & Co. Pay Page Integration Guide Litle & Co. XML Differences Guide Litle & Co. Merchant Provisioner API Reference Guide Document Version: 1.8 ix

10 About This Guide Typographical Conventions Typographical Conventions Table 2 describes the conventions used in this guide. TABLE 2 Convention... Typographical Conventions Meaning Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.... Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted. < > Angle brackets are used in the following situations: user-supplied values (variables) XML elements [ ] Brackets enclose optional clauses from which you can choose one or more options. bold text Italicized text blue text Bold text indicates emphasis. Italic type in text indicates a term defined in the text, the glossary, or in both locations. Blue text indicates a hypertext link. x Document Version: 1.8

11 Contact Information About This Guide Contact Information This section provides contact information for organizations within Litle & Co. Implementation - For certification and technical issues concerning your implementation of LitleXML, contact the Implementation Department. You can call your assigned Litle Implementation Analyst or send to the address below. Implementation Contact Information Hours Available implementation@litle.com Monday Friday, 8:30 a.m. 5:30 p.m. EST Technical Support - For technical issues such as file transmission errors, Technical Support. A Technical Support Representative will contact you within 15 minutes to resolve the problem. Technical Support Contact Information Hours Available support@litle.com 24/7 (24 hours a day, seven days a week) Customer Experience Management/Customer Service - For non-technical issues, including questions concerning the user interface, help with passwords, modifying merchant details, and changes to user account permissions, contact the Customer Experience Management/Customer Service Department. Customer Experience Management/Customer Service Contact Information Telephone Hours Available customerservice@litle.com Monday Friday, 8:00 A.M. 6:30 P.M. EST Chargebacks - For questions regarding financial transactions and documentation related to chargeback cases, contact the Chargebacks Department. Chargebacks Contact Information Telephone (option 4) chargebacks@litle.com Document Version: 1.8 xi

12 About This Guide Contact Information Chargebacks Contact Information Hours Available Monday Friday, 8:30 a.m. 5:30 p.m. EST Technical Publications - For questions or comments about this document, please address your feedback to the Technical Publications Department. All comments are welcome. Technical Publications Contact Information TechPubs@litle.com xii Document Version: 1.8

13 1 INTRODUCTION The Litle Scheduled Secure Reports (SSR) service is an automated service designed to create one or more predefined reports and make them available in your merchant FTP account for retrieval. This service provides the following benefits: Security reports are delivered through secure FTP, minimizing the risk of data compromise. The report FTP account is unique and distinct from your transaction processing FTP account, improving access control to your reporting data. Flexibility reports are accessible in your secure FTP directory for up to seven days. Reliability Built-in features automatically detect if a scheduled report did not run on time, allowing Litle to address delivery issues promptly. Accuracy scheduled reports are consistent with reports available in our UI. Evolution new fields added to scheduled reports are included automatically, providing the most complete and valuable data set that we offer. Any new field will be appended to the end of each data set to avoid disruption to automated parsing mechanisms. Document Version: 1.8 1

14 Introduction Available Reports 1.1 Available Reports The following reports are currently available via the SSR system: Net Settled Sales by Transaction Report - includes all settled and conveyed transactions (deposits and refunds), including echeck transactions. The report can be scheduled based upon either Activity (post) or Settlement (funds transfer) day. Session Report - includes all transactions for a particular activity post day and allows reconciliation against submitted transactions. Transaction Summary Report - includes summarized deposits and refunds (both settled and conveyed) submitted by the merchant and broken down by purchase currency, reporting groups, and payment type for a particular activity post day. Activity Report - includes summarized financial data for transactions (deposits and refunds) based upon activity post date and broken down by Reporting Group and payment type. Settlement Report - includes summarized financial data for settled transactions (deposits and refunds) based upon settlement (funds transfer) date and broken down by Reporting Group and payment type. Chargeback Financial Report - includes detailed information about financial impacting chargeback activities for a given activity (post) or fund transfer (settlement) date. Chargeback Status Report - provides details of all chargeback activities for a designated activity (post day) date or date range in the case of a monthly report. This report is run daily or monthly. Fraud Alert Report - a list of MasterCard and Visa transactions confirmed to be fraudulent. Customer Insights Report - provides transaction details for a designated activity (post day) that include Insights data. Fee Report - provides a detailed breakdown of all Litle and Passthrough (Interchange) fees associated with transactions for a given activity (post) or fund transfer (settlement) date. 2 Document Version: 1.8

15 Managing Report Subscriptions Introduction 1.2 Managing Report Subscriptions If you have the proper permission level, you can manage your report subscriptions via the Manage Scheduled Reports page. Using this interface you can select which reports you want to receive, as well as the frequency the system generates the reports (not available for all reports). NOTE: You cannot manage the following three reports associated with Value Added Services from this interface: Fraud Advice, AU Repaired Auth, and Customer Insights. Access to these reports are configured when you subscribe to the associated services. FIGURE 1-1 To manage the reports you receive: 1. Access the Manage Scheduled Reports page by clicking the link on the Home page. 2. Check the Subscribe checkboxes for the reports to which you wish to subscribe, or uncheck the boxes for those reports you wish to discontinue receiving. 3. If applicable, for each select the Frequency you wish yo receive the selected reports. 4. Click the Save Subscription button to save your settings. Document Version: 1.8 3

16 Introduction Retrieving Reports 1.3 Retrieving Reports There are two methods you can use to retrieve scheduled reports. You can access your FTP directory using the credentials supplied by your Litle Implementation Consultant. All reports generated via the SSR mechanism are available for download for seven (7) days from the date of creation. After seven days the files are purged from the FTP account. The Litle UI provides a second means of accessing you scheduled reports. From the My Scheduled Reports page, you can view a list of available reports. Selecting an available report allows you to download the report from your FTP site via the interface. NOTE: If you need an older report that has been purged, please contact your Litle Customer Experience manager to have the report re-run. 4 Document Version: 1.8

17 Microsoft Excel Limitations Introduction 1.4 Microsoft Excel Limitations Due to certain limitations, data in some cells may not appear as expected when the exported CSV file is viewed in Microsoft Excel: 15-Digit Limitation - you may notice that the values in certain report fields are preceded by a single quote character ( ) when opened as a Microsoft Excel file. Excel has a limitation whereby a column that contains a number greater than 15 digits in length is truncated. When the column is viewed as a number, Excel replaces the trailing digits with zeros, resulting in an invalid value. To address this, Litle has preceded each impacted column with a single quote in the exported report. This ensures that Excel interprets the information as text and displays the values accordingly. To remove all of the single quotations, simply apply the following formula to the affected columns: "=MID(B1, 2, LEN(B1)) Leading Zeros Removed - you may also notice that certain columns may include a two or three-digit value. This occurs when the last four digits of the Account Number, the Account Suffix, contains leading zeros. For example, if the Account Suffix is 0021, the value is displayed as 21. Excel treats the Account Suffix as a numeric value and removes the leading zeros. Document Version: 1.8 5

18 Introduction Microsoft Excel Limitations 6 Document Version: 1.8

19 2 NET SETTLED SALES BY TRANSACTION REPORT The Net Settled Sales by Transaction report, which is used primarily for fiscal reconciliation, includes all settled and conveyed transactions (deposits and refunds), including echeck transactions. The report can be scheduled based upon either activity (post) or settlement (funds transfer) day. The report is produced daily. Document Version: 1.8 7

20 Net Settled Sales by Transaction Report Filename Syntax 2.1 Filename Syntax The syntax of the report filename is either: or where Financial_Detail_NssByTxnByActivityDate${rptCategoryId}${currencyAlpha}${conveye d}${negativerefund}_${organizationid}_${targetday} Financial_Detail_NssByTxnBySettlementDate${rptCategoryId}${currencyAlpha}${negat iverefund}_${organizationid}_${targetday} rptcategoryid is the ID of the Reporting Group to which the report applies. If the report is not filtered by Reporting Group, this value is replaced by a 0. currencyalpha is the 3-digit ISO 4217 currency code for the currency of the transactions included in the report. If the report includes all currencies, this value is replaced by a 0. conveyed is a flag indicating if the report should include conveyed transactions (applies only to Activity Date based reports) negativerefund is a flag indicating if refunds contained in the report appear preceeded by a minus sign (-) organizationid is the ID of the parent merchant organization targetday is the date for which the data applies (for example, for June 15, 2012) 8 Document Version: 1.8

21 Report Structure Net Settled Sales by Transaction Report 2.2 Report Structure The table below provides information about the fields included in the report. The report fields are in the order presented in the table. NOTE: A data type of Signed Decimal (17,2) with a Max Size of 21 is defined as: 17 digits + decimal point + 2 digits + sign. TABLE 2-1 NSS by Transaction Report Fields Field Name Data Type Max Size Description Report Group Alphanumeric 50 The Reporting Group to which the transaction belongs. Merchant Alphanumeric 50 The name of the parent organization (or division) that submitted the transaction. Activity Date Date (MM/dd/yyyy) 10 The original date of the submitted transaction. Settlement Date Date (MM/dd/yyyy) 10 The date that Litle & Co. initiated the funds transfer to your merchant account. Litle Payment ID Parent Litle Payment ID Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) 20 The unique identifier automatically assigned to each transaction by Litle & Co. and associated with the transaction. 20 The Litle Payment ID for the parent transaction. For example, if the transaction was a capture, this is the Litle Payment ID for the associated Authorization transaction. Merchant Order Number Alphanumeric 25 The merchant-designated identifier for this transaction. Txn Type Alphanumeric 50 The type of transaction (for example, Deposit or Refund). Document Version: 1.8 9

22 Net Settled Sales by Transaction Report Report Structure TABLE 2-1 NSS by Transaction Report Fields Field Name Data Type Max Size Description Purchase Currency Alphanumeric 5 The currency used for the purchase, designated by a three-character abbreviation of the country. Purchase Amt Signed Decimal (17,2) 21 The total dollar amount of the purchase. Settlement Currency Alphanumeric 5 The currency used for the settlement, designated by a three-character abbreviation of the country. Settlement Amt Signed Decimal (17,2) 21 The settlement amount for this transaction. Payment Type Alphanumeric 50 The method of payment (Visa, MasterCard, etc.) for this transaction. Account Suffix Numeric 4 The account number suffix that the customer used for this transaction. Regardless of account permissions, only the last four digits are visible for credit cards, and the last three digits for echecks. BIN Numeric 6 The bank identification number, which is the first six digits of the credit card number used for the transaction. This uniquely identifies the institution that issued the credit card to the card holder. Response Reason Message Alphanumeric 80 The transaction response returned by Litle for this transaction. If the transaction was declined, this message provides a reason. Batch ID Numeric (with preceding apostrophe) 20 The unique number automatically assigned by Litle & Co. for the batch associated with the transaction. 10 Document Version: 1.8

23 Report Structure Net Settled Sales by Transaction Report TABLE 2-1 NSS by Transaction Report Fields Field Name Data Type Max Size Description Session ID ARN Numeric (with preceding apostrophe) Alphanumeric (with preceding apostrophe) 20 The unique number automatically assigned by the system for the session associated with the transaction. 23 The Acquirer Reference Number (ARN) that uniquely identifies this transaction with the Card Networks. Interchange Rate Alphanumeric 100 The Interchange Qualification rate for this transaction, as designated by the Card Networks. Customer ID Alphanumeric 50 The unique identifier for the purchaser associated with the transaction. Merchant Transaction ID Alphanumeric 25 The identifier specified by the merchant for this transaction. This value corresponds to the id attribute (id="value") of the transaction and is used with Online transactions for Duplicate Transaction Detection. Affiliate Alphanumeric 25 The merchant-specified identifier used to track transactions associated with your affiliate organizations. Campaign Alphanumeric 25 The merchant-specified identifier used to track transactions associated with specific marketing campaigns. Merchant Grouping ID Alphanumeric 25 The merchant-specified identifier for grouping transactions by an additional transaction level ID outside of Affiliate or Campaign. Document Version:

24 Net Settled Sales by Transaction Report Report Structure TABLE 2-1 NSS by Transaction Report Fields Field Name Data Type Max Size Description Token Number Numeric 50 The reference number (token) issued by Litle & Co. to replace the submitted credit card number or echeck account number. Transaction Processing Timestamp GMT Timestamp (MM/dd/yyyy HH:mm:ss) 23 The date and time (GMT) the transaction was processed by Litle & Co. Approximate Interchange Fee Amount Decimal (17,2) 20 The approximate interchange fee amount assessed for the transaction by parties other than Litle (pass-through fees). Interchange Flat Rate Decimal 17 The flat rate of interchange for this payment. Interchange Percent Rate Decimal 10 The percent rate of interchange for this payment. Funding Method Alphanumeric 50 Defines the Funding Method for the transaction as either Settled or Conveyed. Issuing Bank Alphanumeric 100 The name of the Issuing Bank. Billing Descriptor Alphanumeric 25 The text shown on the customer bill. This is either the default (hard-coded billing descriptor), or the value designated in the transaction (soft billing descriptor. Merchant ID Alphanumeric 50 The value of the merchantid element/attribute submitted in the LitleXML transaction. 12 Document Version: 1.8

25 3 SESSION REPORT The Session report including all transactions for a particular activity day. This report is run daily and is used primarily for transaction reconciliation. Document Version:

26 Session Report Filename Syntax 3.1 Filename Syntax The syntax of the report filename is: where Transactional_Detail_SessionByActivityDate${presenterId}_${organizationId}_${tar getday} presenterid is the ID of the presenter organizationid is the ID of the parent merchant organization targetday is the date to which the data applies 14 Document Version: 1.8

27 Report Structure Session Report 3.2 Report Structure The table below provides information about the fields included in the report. The report fields are in the order presented in the table. NOTE: A data type of Signed Decimal (17,2) with a Max Size of 21 is defined as: 17 digits + decimal point + 2 digits + sign. TABLE 3-1 Session Report Fields Field Name Data Type Max Size Description Session ID Batch ID Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) 20 The unique number automatically assigned by Litle & Co. for the session associated with the transaction. 20 The unique number automatically assigned by the system for the batch associated with the transaction. Batch Post Day Date (MM/dd/yyyy) 10 The post date the batch was submitted. Response Time Batch Completion Timestamp (MM/dd/yyyy HH:mm:ss) Timestamp (MM/dd/yyyy HH:mm:ss) 22 The date and time the transaction was processed by Litle & Co. 22 The date and time the batch was processed completely by Litle & Co. Reporting Group Alphanumeric 50 The Reporting Group to which the transaction belongs. Presenter Alphanumeric 15 The short name that identifies the presenter. Merchant Alphanumeric 50 The name of the parent organization (or division) that submitted the transaction. Document Version:

28 Session Report Report Structure TABLE 3-1 Session Report Fields Field Name Data Type Max Size Description Merchant ID Alphanumeric 50 The value of the merchantid element/attribute submitted in the LitleXML transaction. Litle Payment ID Parent Litle Payment ID Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) 20 The unique identifier automatically assigned to each transaction by Litle & Co. and associated with the transaction. 20 The Litle Payment ID for the parent transaction. For example, if the transaction was a capture, this is the Litle Payment ID for the Authorization transaction. Merchant Order Number Alphanumeric 25 The merchant-designated identifier for this transaction. Customer ID Alphanumeric 50 The unique identifier for the purchaser associated with the transaction. Txn Type Alphanumeric 50 The type of transaction (for example, Deposit or Refund). Purchase Currency Alphanumeric 5 The currency used for the purchase, designated by a three-character abbreviation of the country. Purchase Amt Signed Decimal (17,2) Note: Max Size of 21 consists of 17 digits + decimal point + 2 digits + sign. 21 The total dollar amount of the purchase. Payment Type Alphanumeric 50 The method of payment (Visa, MasterCard, etc.) for this transaction. 16 Document Version: 1.8

29 Report Structure Session Report TABLE 3-1 Session Report Fields Field Name Data Type Max Size Description BIN Numeric 6 The bank identification number, which is the first six digits of the credit card number used for the transaction. This uniquely identifies the institution that issued the credit card to the card holder. Account Suffix Numeric 4 The account number suffix that the customer used for this transaction. Regardless of account permissions, only the last four digits are visible for credit cards, and the last three digits for echecks. Response Reason Code Alphanumeric 3 The 3-digit transaction response code returned by Litle for this transaction. If the transaction was declined, this code provides a reason. Response Reason Message Alphanumeric 80 The transaction response returned by Litle for this transaction. If the transaction was declined, this message provides a reason. AVS Alphanumeric 2 The 2-digit Address Verification Service response code for the transaction. Fraud Check Sum Response Alphanumeric 10 Response received from security services, for example CVV2/CID/CVC2 for Visa, AMEX, and MC. Payer ID Alphanumeric 35 Unique identifier for a PayPal transaction Merchant Transaction ID Alphanumeric 25 The identifier specified by the merchant for this transaction. This value corresponds to the id attribute (id="value") of the transaction and is used with Online transactions for Duplicate Transaction Detection. Document Version:

30 Session Report Report Structure TABLE 3-1 Session Report Fields Field Name Data Type Max Size Description Affiliate Alphanumeric 25 The merchant-specified identifier used to track transactions associated with your affiliate organizations. Campaign Alphanumeric 25 The merchant-specified identifier used to track transactions associated with specific marketing campaigns. Merchant Grouping ID Alphanumeric 25 The merchant-specified identifier for grouping transactions by an additional transaction level ID outside of Affiliate or Campaign. Sales tax Decimal 19 The Sales Tax amount passed in from the merchant for the specific transaction. FTP Filename Alphanumeric 100 Name of the original file submitted by the presenter. 18 Document Version: 1.8

31 4 TRANSACTION SUMMARY REPORT The Transaction Summary report contains the summarized deposits and refunds submitted by the merchant for both settled and conveyed methods of payment, broken down by purchase currency. This report is run daily. Document Version:

32 Transaction Summary Report Filename Syntax 4.1 Filename Syntax The syntax of the report filename is: where Transactional_Summary_TxnReportByActivityDate${rptCategoryId}_${organizationId}_ ${targetday} rptcategoryid is the ID of the Reporting Group to which the report applies. If the report is not filtered by Reporting Group, this value is replaced by a 0. organizationid is the ID of the parent merchant organization targetday is the date to which the data applies 20 Document Version: 1.8

33 Report Structure Transaction Summary Report 4.2 Report Structure The table below provides information about the fields included in the report. The report fields are in the order presented in the table. NOTE: A data type of Signed Decimal (17,2) with a Max Size of 21 is defined as: 17 digits + decimal point + 2 digits + sign. TABLE 4-1 Transaction Summary Reports Fields Field Name Data Type Max Size Description Reporting Group Alphanumeric 50 The Reporting Group to which the transaction belongs. Reporting Group Type Alphanumeric 50 The type of Reporting Group: Transactional, if this Reporting group is at a transaction level (the ones submitted with the transactions) or Rollup, if this contains child Reporting Group. Merchant Alphanumeric 50 The name of the parent organization (or division) that submitted the transaction. Purchase Currency Alphanumeric 5 The currency used for the purchase, designated by a three-character abbreviation of the country. Funding Method Alphanumeric 50 Defines the Funding Method for the transaction as either Settled or Conveyed. Payment Type Alphanumeric 50 The method of payment (Visa, MasterCard, etc.) for this transaction. Txn Status Alphanumeric 50 Indicates the status of the transaction, either Submitted, Approved, or Declined. Document Version:

34 Transaction Summary Report Report Structure TABLE 4-1 Transaction Summary Reports Fields Field Name Data Type Max Size Description Txn Type Alphanumeric 50 Indicates whether the transaction was a Deposit or a Refund. Litle Initiated Alphanumeric 5 Indicates whether or not this transaction originated from Litle. Yes = Litle Initiated No = Merchant Initiated Count Numeric 15 The total number of transactions included in this Reporting Group Amount Decimal (17,2) 21 The total dollar amount of all transactions in this Reporting Group. 22 Document Version: 1.8

35 5 ACTIVITY AND SETTLEMENT REPORTS Both the Activity and Settlement reports contain summarized financial data for settled transactions. The information in the Activity report is based upon activity post date, while the Settlement report information is based upon the settlement transfer date. The report is produced either daily or for the previous calendar month. Document Version:

36 Activity and Settlement Reports Filename Syntax 5.1 Filename Syntax The syntax of the report filename is either: Financial_Summary_ActivityReport${rptCategoryId}_${organizationId}_${targetDay} for the Activity report, or Financial_Summary_SettlementReport${rptCategoryId}_${organizationId}_${targetDay} for the Settlement report, where rptcategoryid is the ID of the Reporting Group to which the report applies. If the report is not filtered by Reporting Group, this value is replaced by a 0. organizationid is the of the parent merchant organization targetday is the date to which the data applies 24 Document Version: 1.8

37 Report Structure Activity and Settlement Reports 5.2 Report Structure The table below provides information about the fields included in the report. The report fields are in the order presented in the table. NOTE: A data type of Signed Decimal (17,2) with a Max Size of 21 is defined as: 17 digits + decimal point + 2 digits + sign. TABLE 5-1 Activity and Settlement Reports Fields Field Name Data Type Max Size Description Reporting Group Alphanumeric 50 The Reporting Group to which the transaction belongs. Reporting Group Type Alphanumeric 50 The type of Reporting Group: Transactional, if this Reporting group is at a transaction level (the ones submitted with the transactions) or Rollup, if this contains child Reporting Group. Merchant Alphanumeric 50 The name of the parent organization (or division) that submitted the transaction. Payment Type Alphanumeric 50 The method of payment (Visa, MasterCard, etc.) for this transaction. Activity Date Date (MM/dd/yyyy) 10 The original date of the transaction Settlement Date Date (MM/dd/yyyy) 10 The date that Litle & Co. sent the settled funds to your merchant account. Settlement Currency Alphanumeric 5 The currency used for the settlement, designated by a three-character abbreviation of the country. Document Version:

38 Activity and Settlement Reports Report Structure TABLE 5-1 Activity and Settlement Reports Fields Field Name Data Type Max Size Description Settled Deposits Signed Decimal (17,2) 21 The total dollar amount of the deposits summed for the Reporting Group. Settled Refunds Signed Decimal (17,2) 21 The total dollar amount of the refunds summed for the Reporting Group. Chargebacks/Returns Signed Decimal (17,2) 21 The total dollar amount of the chargebacks and echeck returns summed for the Reporting Group. Litle Fees Signed Decimal (17,2) 21 The total dollar amount of fees charged by Litle & Co. Passthrough Fees Signed Decimal (17,2) 21 The total dollar amount of the transaction fees charged by the network and passed through Litle. Reserve Activity Signed Decimal (17,2) 21 The total dollar amount of reserve withheld by Litle & Co. in this Reporting Group. 3rd Party Payments Signed Decimal (17,2) 21 The total dollar amount of any third-party payments included in this Reporting Group. Count Numeric 19 The total number of transactions included in this Reporting Group 26 Document Version: 1.8

39 6 CHARGEBACK FINANCIAL REPORT Chargeback Financial (Activity) report provides details of chargeback activities for either a designated activity (post day) or fund transfer (settlement) date. This report is run daily. Document Version:

40 Chargeback Financial Report Filename Syntax 6.1 Filename Syntax The syntax of the report filename is either: or Financial_Detail_ChargebackFinancialByActivityDate${rptCategoryId}_${organizatio nid}_${targetday} Financial_Detail_ChargebackFinancialBySettlementDate${rptCategoryId}_${organizati onid}_${targetday} where rptcategoryid is the ID of the Reporting Group to which the report applies. If the report is not filtered by Reporting Group, this value is replaced by a 0. organizationid is the ID of the parent merchant organization targetday is the date to which the data applies 28 Document Version: 1.8

41 Report Structure Chargeback Financial Report 6.2 Report Structure The table below provides information about the fields included in the report. The report fields are in the order presented in the table. NOTE: A data type of Signed Decimal (17,2) with a Max Size of 21 is defined as: 17 digits + decimal point + 2 digits + sign. TABLE 6-1 Chargeback Financial Report Fields Field Name Data Type Max Size Description Case ID Litle Payment ID Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) 20 This field contains the unique Litle assigned ID for a chargeback or the return ID for an Echeck return. 20 The unique identifier automatically assigned to each transaction by Litle & Co. and associated with the transaction. Merchant Order Number Alphanumeric 25 The merchant-designated identifier for this transaction. Account Suffix Numeric 4 The account number suffix that the customer used for this transaction. Regardless of account permissions, only the last four digits are visible for credit cards, and the last three digits for echecks. BIN Numeric 6 The bank identification number, which is the first six digits of the credit card number used for the transaction. This uniquely identifies the institution that issued the credit card to the card holder. Payment Type Alphanumeric 50 The method of payment (Visa, MasterCard, etc.) for this transaction. Reason Code Alphanumeric 25 Code indicating why this chargeback or echeck return was initiated. Document Version:

42 Chargeback Financial Report Report Structure TABLE 6-1 Chargeback Financial Report Fields Field Name Data Type Max Size Description Reason Description Alphanumeric 100 Description corresponding to Reason Code. Date Issued Date (MM/dd/yyyy) 10 The day the issuing bank processed the chargeback or echeck return. Date Received Date (MM/dd/yyyy) 10 The day that Litle received the chargeback or echeck return from the network. Reply by Date Date (MM/dd/yyyy) 10 The day by which merchants must respond to the case. Note: Since this field does not apply to echeck returns, it will be empty. Chargeback Currency Alphanumeric 50 The currency used for the chargeback. Chargeback Amt Signed Decimal (17,2) 21 The disputed dollar amount of the chargeback or echeck return. Auth Date Date (MM/dd/yyyy) 10 The date of the original Authorization. Auth Currency Alphanumeric 50 The currency used for the Authorization amount. Auth Amt Signed Decimal (17,2) 21 The total dollar amount of the original authorization. Note: This field is empty for echeck. Transaction Date Date (MM/dd/yyyy) 10 The date of the original transaction. Transaction Purchase Currency Alphanumeric 50 The currency used for the transaction purchase amount. Transaction Purchase Amt Signed Decimal (17,2) 21 The total dollar amount of the original purchase. Transaction Settlement Currency Alphanumeric 50 The currency used for the transaction settlement amount. Transaction Settlement Amt Signed Decimal (17,2) 21 The total dollar amount of the purchase in the settlement currency. Activity Date Date (MM/dd/yyyy) 10 The original date of the transaction 30 Document Version: 1.8

43 Report Structure Chargeback Financial Report TABLE 6-1 Chargeback Financial Report Fields Field Name Data Type Max Size Description Settlement Date Date (MM/dd/yyyy) 10 The date that Litle & Co. sent the settled funds to your merchant account. Activity Alphanumeric 50 The activity performed on the chargeback. Possible values are: Add Note Assign To Litle Assign To Merchant Assign To Merchant Automated Assign to User Attach Document Auto Represent File Pre-arbitration Merchant Accepts Liability Merchant Accepts Liability - PayPal Merchant Represent Merchant Requests Arbitration Merchant Respond Merchant Respond - Sent Credit Move To Litle Error Queue Network Accepted Network Decision Receive Network Transaction Request Declined Send Representment Send Retrieval Request Response Successful PayPal Case ACH echeck Returns Document Version:

44 Chargeback Financial Report Report Structure TABLE 6-1 Chargeback Financial Report Fields Field Name Data Type Max Size Description Cycle Alphanumeric 25 The current cycle of the chargeback. Possible values are: ARBITRATION_CHARGEBACK CHARGEBACK_REVERSAL FIRST_CHARGEBACK ISSUER_ARB_CHARGEBACK PRE_ARB_CHARGEBACK REPRESENTMENT RETRIEVAL_REQUEST Note: For echeck returns, this column will be empty. Campaign Alphanumeric 25 The merchant-specified identifier used to track transactions associated with specific marketing campaigns. Merchant Name Alphanumeric 50 The name of the parent organization (or division) that submitted the transaction. Affiliate Alphanumeric 25 The merchant-specified identifier used to track transactions associated with your affiliate organizations. Merchant Grouping ID Alphanumeric 25 The merchant-specified identifier for grouping transactions by an additional transaction level ID outside of Affiliate or Campaign. Report Group Alphanumeric 50 The Reporting Group to which the transaction belongs. Txn Type Alphanumeric 50 The type of transaction (for example, Deposit or Refund). Batch ID Session ID Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) 20 The unique number automatically assigned by the system for the batch associated with the transaction. 20 The unique number automatically assigned by the system for the session associated with the transaction. 32 Document Version: 1.8

45 Report Structure Chargeback Financial Report TABLE 6-1 Chargeback Financial Report Fields Field Name Data Type Max Size Description ARN Alphanumeric (with preceding apostrophe) 23 The Acquirer Reference Number (ARN) that uniquely identifies this transaction with the networks. Customer ID Alphanumeric 50 The unique identifier for the purchaser associated with the transaction. Merchant Transaction ID Alphanumeric 25 The identifier specified by the merchant for this transaction. This value corresponds to the id attribute (id="value") of the transaction and is used with Online transactions for Duplicate Transaction Detection. Billing Descriptor Alphanumeric 25 The text shown on the customer bill. This is either the default (hard-coded billing descriptor), or the value designated in the transaction (soft billing descriptor. Assigned To Alphanumeric 105 The name of the user to which the chargeback is assigned. Assigned To User Type Alphanumeric 15 Defines the type of user as one of the following: LITLE MERCHANT PRESENTER MULTI_ORG Issuing Bank Country Code Alpha 3 The 3-character alpha country code indicating the location of the issuing bank. Merchant ID Alphanumeric 50 The value of the merchantid element/attribute submitted in the LitleXML transaction. Document Version:

46 Chargeback Financial Report Report Structure TABLE 6-1 Chargeback Financial Report Fields Field Name Data Type Max Size Description Issuing Bank Alphanumeric 100 The name of the issuing bank. If the value is null and the Payment Type is either Visa or MasterCard, then the issuing bank in unknown. If the Payment Type is American Express, the issuing bank in American Express. If the Payment Type is Discover, the issuing bank in Discover. Presenter Alphanumeric 15 The short name of the presenter. 34 Document Version: 1.8

47 7 CHARGEBACK STATUS REPORT Chargeback Status report provides details of all chargeback activities for a designated activity (post day) date or date range in the case of a monthly report. The report is produced either daily or for the previous calendar month Document Version:

48 Chargeback Status Report Filename Syntax 7.1 Filename Syntax The syntax of the report filename is either: or Transactional_Detail_ChargebackStatusByActivityDate_${organizationId}_${targetDa y} Transactional_Detail_ChargebackStatusByActivityDate_${organizationId}_${activityS tartdate}_${activityenddate} where rptcategoryid is the ID of the Reporting Group to which the report applies organizationid is the ID of the parent merchant organization targetday is the date to which the data applies activitystartdate is the start day of the date range activityenddate is the end day of the date range 36 Document Version: 1.8

49 Report Structure Chargeback Status Report 7.2 Report Structure The table below provides information about the fields included in the report. The report fields are in the order presented in the table. NOTE: A data type of Signed Decimal (17,2) with a Max Size of 21 is defined as: 17 digits + decimal point + 2 digits + sign. TABLE 7-1 Chargeback Status Report Fields Field Name Data Type Max Size Description Case ID Litle Payment ID Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) 20 This field contains the unique Litle assigned ID for a chargeback or the return ID for an Echeck return. 20 The unique identifier automatically assigned to each transaction by Litle & Co. and associated with the transaction. Merchant Order Number Alphanumeric 25 The merchant-designated identifier for this transaction. Account Suffix Numeric 4 The account number suffix that the customer used for this transaction. Regardless of account permissions, only the last four digits are visible for credit cards, and the last three digits for echecks. BIN Numeric 6 The bank identification number, which is the first six digits of the credit card number used for the transaction. This uniquely identifies the institution that issued the credit card to the card holder. Payment Type Alphanumeric 50 The method of payment (Visa, MasterCard, etc.) for this transaction. Reason Code Alphanumeric 25 Code indicating why this chargeback or echeck return was initiated. Document Version:

50 Chargeback Status Report Report Structure TABLE 7-1 Chargeback Status Report Fields Field Name Data Type Max Size Description Reason Description Alphanumeric 100 Description corresponding to Reason Code. Date Issued Date (MM/dd/yyyy) 10 The day the issuing bank processed the chargeback or echeck return. Date Received Date (MM/dd/yyyy) 10 The day that Litle received the chargeback or echeck return from the network. Reply by Date Date (MM/dd/yyyy) 10 The day by which merchants must respond to the case. Note: Since this field does not apply to echeck returns, it will be empty. Chargeback Currency Alphanumeric 50 The currency used for the chargeback. Chargeback Amt Signed Decimal (17,2) 21 The disputed dollar amount of the chargeback or echeck return. Auth Date Date (MM/dd/yyyy) 10 The date of the original Authorization. Auth Currency Alphanumeric 50 The currency used for the Authorization amount. Auth Amt Signed Decimal (17,2) 21 The total dollar amount of the original authorization. Note: This field is empty for echeck. Transaction Date Date (MM/dd/yyyy) 10 The date of the original transaction. Transaction Purchase Currency Alphanumeric 50 The currency used for the transaction purchase amount. Transaction Purchase Amt Signed Decimal (17,2) 21 The total dollar amount of the original purchase. Transaction Settlement Currency Alphanumeric 50 The currency used for the transaction settlement amount. Transaction Settlement Amt Signed Decimal (17,2) 21 The total dollar amount of the purchase in the settlement currency. Activity Date Date (MM/dd/yyyy) 10 The original date of the transaction 38 Document Version: 1.8

51 Report Structure Chargeback Status Report TABLE 7-1 Chargeback Status Report Fields Field Name Data Type Max Size Description Activity Alphanumeric 50 The activity performed on the chargeback. Possible values are: Add Note Assign To Litle Assign To Merchant Assign To Merchant Automated Assign to User Attach Document Auto Represent File Pre-arbitration Merchant Accepts Liability Merchant Accepts Liability - PayPal Merchant Represent Merchant Requests Arbitration Merchant Respond Merchant Respond - Sent Credit Move To Litle Error Queue Network Accepted Network Decision Receive Network Transaction Request Declined Send Representment Send Retrieval Request Response Successful PayPal Case ACH echeck Returns Document Version:

52 Chargeback Status Report Report Structure TABLE 7-1 Chargeback Status Report Fields Field Name Data Type Max Size Description Cycle Alphanumeric 25 The current cycle of the chargeback. Possible values are: ARBITRATION_CHARGEBACK CHARGEBACK_REVERSAL FIRST_CHARGEBACK ISSUER_ARB_CHARGEBACK PRE_ARB_CHARGEBACK REPRESENTMENT RETRIEVAL_REQUEST Note: For echeck returns, this column will be empty. Campaign Alphanumeric 25 The merchant-specified identifier used to track transactions associated with specific marketing campaigns. Merchant Name Alphanumeric 50 The name of the parent organization (or division) that submitted the transaction. Affiliate Alphanumeric 25 The merchant-specified identifier used to track transactions associated with your affiliate organizations. Merchant Grouping ID Alphanumeric 25 The merchant-specified identifier for grouping transactions by an additional transaction level ID outside of Affiliate or Campaign. Txn Type Alphanumeric 50 The type of transaction (for example, Deposit or Refund). Batch ID Session ID ARN Numeric (with preceding apostrophe) Numeric (with preceding apostrophe) Alphanumeric (with preceding apostrophe) 20 The unique number automatically assigned by the system for the batch associated with the transaction. 20 The unique number automatically assigned by the system for the session associated with the transaction. 23 The Acquirer Reference Number (ARN) that uniquely identifies this transaction with the networks. 40 Document Version: 1.8

53 Report Structure Chargeback Status Report TABLE 7-1 Chargeback Status Report Fields Field Name Data Type Max Size Description Customer ID Alphanumeric 50 The unique identifier for the purchaser associated with the transaction. Merchant Transaction ID Alphanumeric 25 The identifier specified by the merchant for this transaction. This value corresponds to the id attribute (id="value") of the transaction and is used with Online transactions for Duplicate Transaction Detection. Billing Descriptor Alphanumeric 25 The text shown on the customer bill. This is either the default (hard-coded billing descriptor), or the value designated in the transaction (soft billing descriptor. Assigned To Alphanumeric 105 The name of the user to which the chargeback is assigned. Assigned To User Type Alphanumeric 15 Defines the type of user as one of the following: LITLE MERCHANT PRESENTER MULTI_ORG Issuing Bank Country Code Alpha 3 The 3-character alpha country code indicating the location of the issuing bank. Merchant ID Alphanumeric 50 The value of the merchantid element/attribute submitted in the LitleXML transaction. Issuing Bank Alphanumeric 100 The name of the issuing bank. If the value is null and the Payment Type is either Visa or MasterCard, then the issuing bank in unknown. If the Payment Type is American Express, the issuing bank in American Express. If the Payment Type is Discover, the issuing bank in Discover. Document Version: