Reporting Guidelines

(external use)

All reports are a csv file and the timezone UTC at all times.

All reports will be placed on the SFTP. Reports that have no transactions will be placed on the SFTP but will be empty with no records.

All Settlement reports are also available as Recon Report to reconcile the previous day or any other given timeframe. See details below the table

Sample Reports:

MERCHANT_XXX_AGGREGATED_SETTLEMENT_report_2018-06-01.csv

MERCHANT_XXX_SETTLEMENT_CUSTOM_report_2018-07-11.csv

MERCHANT_XXX_daily_FRAUDREPORT_report_2018-07-27.csv

MERCHANT_XXX_daily_PAYMENT_report_2018-07-18.csv

MERCHANT_XXX_daily_CHARGEBACK_report_2018-07-18.csv

Report Type	Description	Syntax	Frequency	Date / Time Frame	Date Range Sample	Report generated at time
Settlement Report -31 days	This report is being used when the settlement happens after the regular acquirer settlement in Brazil which is 30 days after the transaction has happened. At PrimeiroPay we pay you on the 30th day from 3pm UTC to the next day 3pm UTC. As a part of our Transparency policy trading will happen at 3pm UTC daily, so you can monitor the FX rates.	MerchantID_ReportID_SETTLEMENT_PREVIOUS_24_FULL_HOURS_MINUS_31_DAYS_report_YYYY-MM-DD.csv The time stamp in the report name refers to when the transaction happened, not to the date when the report was generated Every Monday the report syntax changes to MerchantID_ReportID_SETTLEMENT_PREVIOUS_72_FULL_HOURS_MINUS_31_DAYS_report_YYYY-MM-DD.csv as there is no FX trading possible during the weekend.	Daily on weekdays after initial 31 days	31 days before report generated Timeframe fixed to: 3pm UTC to 3pm UTC next day	Report Date: October 1 Transaction Date: July 31 3pm UTC to August 1 3pm UTC	3.00-3.59pm
Settlement Report previous day	As a part of our Transparency policy trading will happen at 3pm UTC daily, so you can monitor the FX rates. That means transactions will include transactions from the previous day 3pm to today 3pm Fields in a settlement report: Company Account,Merchant Account,Psp Reference,Merchant Reference,Payment Method,Creation Date,TimeZone,Type,Modification Reference,Gross Currency,Gross Debit (GC),Gross Credit (GC),Exchange Rate,Net Currency,Net Debit (NC),Net Credit (NC),Commission (NC),Markup (NC),Scheme Fees (NC),Interchange (NC),Payment Method Variant,Modification Merchant Reference,Batch Number,Installments,Card Holder,Reserved6,Reserved7,Reserved8,Reserved9,Reserved10,TAXSTATEMENT	MerchantID_ReportID_SETTLEMENT_PREVIOUS_24_FULL_HOURS_report_YYYY-MM-DD.csv Every Monday the report syntax changes to MerchantID_ReportID_SETTLEMENT_PREVIOUS_72_FULL_HOURS_report_YYYY-MM-DD.csv	Daily on weekdays	Timeframe fixed to: 3pm UTCp previous day to 3pm UTC today	Report Date: October 2 Transaction Date: October 1 3pm UTC to October 2 3pm UTC	3.00-3.59pm
Settlement Report previous half month	Settlement that happens bi-weekly without the 30 day delay of settlement of the acquirer Fields in a settlement report: Company Account,Merchant Account,Psp Reference,Merchant Reference,Payment Method,Creation Date,TimeZone,Type,Modification Reference,Gross Currency,Gross Debit (GC),Gross Credit (GC),Exchange Rate,Net Currency,Net Debit (NC),Net Credit (NC),Commission (NC),Markup (NC),Scheme Fees (NC),Interchange (NC),Payment Method Variant,Modification Merchant Reference,Batch Number,Installments,Card Holder,Reserved6,Reserved7,Reserved8,Reserved9,Reserved10,TAXSTATEMENT	MerchantID_ReportID_SETTLEMENT_PREVIOUS_HALF_MONTH_report_YYYY-MM-DD	Bi-weekly	24hrs	Transactions between October 1 to October 15 when report runs on Oct 16	8.00-8.59am
Settlement Report previous month	Settlement that happens for all transactions of the previous month without the 30 day delay of settlement of the acquirer Fields in a settlement report: Company Account,Merchant Account,Psp Reference,Merchant Reference,Payment Method,Creation Date,TimeZone,Type,Modification Reference,Gross Currency,Gross Debit (GC),Gross Credit (GC),Exchange Rate,Net Currency,Net Debit (NC),Net Credit (NC),Commission (NC),Markup (NC),Scheme Fees (NC),Interchange (NC),Payment Method Variant,Modification Merchant Reference,Batch Number,Installments,Card Holder,Reserved6,Reserved7,Reserved8,Reserved9,Reserved10,TAXSTATEMENT	MerchantID_ReportID_SETTLEMENT_SETTLEMENT_PREVIOUS_MONTH_report_YYYY-MM-DD	monthly, 10th of each month	24hrs	All transactions of the previous calendar month	8.00-8.59am
Settlement Report month before previous month	Regular settlement term for a full calendar month after funds are received in full from the acquirer for that calendar month Fields in a settlement report: Company Account,Merchant Account,Psp Reference,Merchant Reference,Payment Method,Creation Date,TimeZone,Type,Modification Reference,Gross Currency,Gross Debit (GC),Gross Credit (GC),Exchange Rate,Net Currency,Net Debit (NC),Net Credit (NC),Commission (NC),Markup (NC),Scheme Fees (NC),Interchange (NC),Payment Method Variant,Modification Merchant Reference,Batch Number,Installments,Card Holder,Reserved6,Reserved7,Reserved8,Reserved9,Reserved10,TAXSTATEMENT	MerchantID_ReportID_SETTLEMENT_MONTH_BEFORE_PREVIOUS_MONTH_report_YYYY-MM-DD	monthly, 10th of each month	24hrs	Report Date: October 1 Transaction Date: August 1 to August 31	5.00-5.59pm
Settlement Report half month before previous month	Settlement that happens bi-weekly after the full refunds are received from the acquirer Fields in a settlement report: Company Account,Merchant Account,Psp Reference,Merchant Reference,Payment Method,Creation Date,TimeZone,Type,Modification Reference,Gross Currency,Gross Debit (GC),Gross Credit (GC),Exchange Rate,Net Currency,Net Debit (NC),Net Credit (NC),Commission (NC),Markup (NC),Scheme Fees (NC),Interchange (NC),Payment Method Variant,Modification Merchant Reference,Batch Number,Installments,Card Holder,Reserved6,Reserved7,Reserved8,Reserved9,Reserved10,TAXSTATEMENT	MerchantID_ReportID_SETTLEMENT_PREVIOUS_PREVIOUS_PREVIOUS_HALF_MONTH_report_YYYY-MM-DD	Bi-weekly	24hrs	Report Date: October 1 Transaction Date: August 16 to August 31	9.00-9.59am
Chargeback & Refund Report	The chargeback report is a report that contains all Chargebacks and Refunds to reconsile / treat them. Refunds also may happen due to Fraud Alerts (see below) Fields in a payment reports: PSP Transaction ID, Merchant Transaction ID, Payment Brand, Purchase Amount, Purchase Currency, Net Amount Net, Currency Transaction, Timestamp, Country Code, Refund Reason	Merchantname_ReportID_daily_CHARGEBACK_report_YYYY-MM-DD	Daily	Previous day (24hrs)	Report Date October 2 Transaction Date: October 1 00.00 UTC to 23.59 UTC	7.00-7.59am UTC
Payment Report	The payment report gives an overview about successful transactions of the previous day. It does not contain any information on Foreign Exchange, Commission (Processing Fee) or any other additional information a Settlement Report provides. Fields in a payment reports: PSP Transaction ID, Merchant Transaction ID, Payment Brand, Purchase Amount, Purchase Currency, Net Amount Net, Currency Transaction, Timestamp, Country Code	Merchantname_ReportID_daily_PAYMENT_report_YYYY-MM-DD	Daily	Previous day (24hrs)	Report Date October 2 Transaction Date: October 1 00.00 UTC to 23.59 UTC	5.00-5.59am UTC
Aggregated Settlement Report	While the Settlement Report provides this for each settlement batch on a transaction level (for each merchant account), the aggregate settlement report can be run both on merchant account and company account level. It includes all batches closed in the chosen period, summarized by merchant account, store, payment method, the day of sale and settlement batch.		any

Settlement / Recon Report Fields:

If the field value is null it means it is empty and will never be filled.

Company Account: Your MerchantID with PrimeiroPay Merchant Account: Your MerchantID with PrimeiroPay Psp Reference: Our Unique ID for this transaction Merchant Reference: Your TransactionID Alt Merchant Reference: In case of Adyen, you will see your TransactionID here and Adyen's PSP Reference in the Merchant Reference Payment Method: Card Brands such as VISA, MASTER, AMEX, ELO Creation Date: Transaction Time Stamp of the transaction TimeZone: UTC Type: settled, refunded or chargeback (in case of Recon report: sentforsettle) Modification Reference: In case of a Refund or Chargeback you will see here the PSP Reference of the original transaction Gross Currency: BRL Gross Debit (GC): Value in XX.XX for Chargebacks and Refunds Gross Credit (GC): Vlaue in XX.XX for Successful transactions Exchange Rate: Exchange Rate applied for this transaction Net Currency: Your Payout Currency, e.g. EUR, USD, GPB, BRL, ... Net Debit (NC): Deduction of Chargebacks and Refunds from your Payout in your Net Currency Net Credit (NC): Payout to you in your Net Currency after our Commission Commission (NC): Our Commission in Net Currency Markup (NC): Markup charges of us in Net Currency if applicable Brazilian Taxes (NC): In case of domestic merchants that get settled locally, the applicable taxes will be shown here Interchange (NC): null Payment Method Variant: Same as Payment Method Modification Merchant Reference: same as Modification Reference Batch Number: Batch number that will be used for settlement to you Installments: Number of Installments used Card Holder: Name of the Card holder Reserved6: null Reserved7: null Reserved8: null Reserved9: null Reserved10: null TAXSTATEMENT: Tax Identification number of the shopper, in case of Brazil "CPF"

Payment Report Fields:

PSP Transaction ID: Our Unique transactionID Merchant Transaction ID: Your TransactionID Payment Brand: Card Brands such as VISA, MASTER, AMEX, ELO Purchase Amount: Gross Amount in BRL Purchase Currency: BRL Net Amount: Payout in BRL after our commission Net Currency : BRL Transaction Timestamp: Time of the transaction, in case of Refund or chargeback, time of chargeback or Refund Country Code: provided by the merchant

Chargeback Report Fields:

PSP Transaction ID: Our Unique transactionID Merchant Transaction ID: Your TransactionID Payment Brand: Card Brands such as VISA, MASTER, AMEX, ELO Purchase Amount: Gross Amount in BRL Purchase Currency: BRL Net Amount: Payout in BRL after our commission Net Currency : BRL Transaction Timestamp: Time of the transaction, in case of Refund or chargeback, time of chargeback or Refund Country Code: provided by the merchant Refund Reason: In case you have activated the Fraud Alert with PrimeiroPay, there will be a value "Fraud Alert" with every Refund that were refunded by PrimeiroPay because of a Fraud Alert.