{"title":"Canada Code of Conduct - Merchant statements","category":"default","creationDate":1776961629,"content":"<p>As a registered Payment Service Provider in Canada, Adyen must comply with the requirements of the <a href=\"https:\/\/www.canada.ca\/en\/financial-consumer-agency\/services\/industry\/laws-regulations\/credit-debit-code-conduct.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Code of Conduct for the Payment Card Industry in Canada<\/a>, referred to as the <em>Canada Code of Conduct<\/em>. The Canada Code of Conduct aims to improve transparency around the total fees (interchange fee, scheme fee, acquirer fees) paid per Payment Card Network Operator (PCNO).<\/p>\n<p>This guide helps you assess the total cost of payment for each payment method. The instructions show how to compute your effective merchant discount rates per PCNO. The <em>effective merchant discount rate<\/em> is the total cost, divided by the total sales volume, for each payment method. To determine these costs, you use the Payment Accounting Report (PAR) or the Interactive Payment Accounting Report (IPAR).<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">Any integration with Adyen.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/issuing\/manage-access\/webservice-roles\">API credential roles<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have the following webservice role:<ul><li markdown=\"1\"><strong>Report service user<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/account\/user-roles\">Customer Area roles<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have one of the following roles to configure report columns: <ul><li markdown=\"1\"><strong>Merchant admin<\/strong><\/li><li markdown=\"1\"><strong>Merchant report<\/strong><\/li><li markdown=\"1\"><strong>Merchant financial<\/strong><\/li><li markdown=\"1\"><strong>Merchant POS Report role<\/strong><\/li><\/ul>Make sure that you have one of the following roles to generate and download reports: <ul><li markdown=\"1\"><strong>Merchant report<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/development-resources\/webhooks\">Webhooks<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">If you want to create your report from an automatically generated Payment Accounting Report instead of the Interactive Payment Accounting Report, subscribe to the following webhook: <ul><li markdown=\"1\"><strong>Standard Webhook<\/strong><\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>To generate a Merchant Statement Report to determine the total cost of payment:<\/p>\n<ol>\n<li>Configure columns for one of the following reports:\n<ul>\n<li><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/#interactive-payment-accounting-report\">Interactive Payment Account Report (IPAR)<\/a><\/li>\n<li><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/\">Payment Accounting Report (PAR)<\/a><\/li>\n<\/ul><\/li>\n<li>Generate and download an IPAR or PAR with the new column structure.<\/li>\n<li>Create a new <strong>Main Amount (SC)<\/strong> column whose value is the gross amount of the transaction.<\/li>\n<li>(Optional) If you transact in multiple currencies, download an <strong>Exchange rate<\/strong> report.<\/li>\n<li>(Optional) If you transact in multiple currencies, convert all Settlement Currency <strong><em>Column Name<\/em> (SC)<\/strong> and <strong>Processing Fee (FC)<\/strong> column values to new Base Currency <strong><em>Column Name<\/em> (BC)<\/strong> column values.<\/li>\n<li>Create a pivot table to aggregate all costs per payment's <strong>PSP Reference<\/strong>.<\/li>\n<li>Run formulas to determine different aggregate transaction costs over your report's time period to determine total transaction costs by payment method.<\/li>\n<\/ol>\n<h2>1. Configure report columns<\/h2>\n<p>To make this report easier to work with, we suggest that you configure the columns of the Payment Accounting Report to contain only the columns needed to calculate your costs.<\/p>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, select <strong>Settings<\/strong> &gt; <strong>Report columns<\/strong>.<\/li>\n<li>Find the Payment Accounting Report you want to use as your base for your payment cost report and select <strong>Configure<\/strong>.\n<ul>\n<li><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/\">Payment accounting<\/a><\/li>\n<li><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/#interactive-payment-accounting-report\">Interactive payment accounting<\/a><\/li>\n<\/ul><\/li>\n<li>\n<p>Select the following columns for your report, and select <strong>Save configuration<\/strong>:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Column<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Psp Reference<\/td>\n<td style=\"text-align: left;\">Unicode Text (16-character)<\/td>\n<td style=\"text-align: left;\">Adyen's 16-character unique reference associated with the transaction\/the request.\u00a0This value is globally unique; quote it when communicating with us about this request.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Payment Method<\/td>\n<td style=\"text-align: left;\">Unicode Text (50-character)<\/td>\n<td style=\"text-align: left;\">The payment method used for the transaction. <br> For example: <em>visa<\/em>, <em>mc<\/em>, <em>amex<\/em>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Booking Date<\/td>\n<td style=\"text-align: left;\">Date field + Time field<\/td>\n<td style=\"text-align: left;\">The timestamp indicating when the event was entered into Adyen's accounting system. The format is <code>YYYY-MM-DD HH:MM:SS<\/code>. <br> For example: <em>2021-07-26 19:58:55<\/em>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Record Type<\/td>\n<td style=\"text-align: left;\">Unicode Text (50-character)<\/td>\n<td style=\"text-align: left;\">The accounting record type.<br>For a list of record types, see <a href=\"#recordtypes\">Record types<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Settlement Currency<\/td>\n<td style=\"text-align: left;\">Alpha Text (3-character limit)<\/td>\n<td style=\"text-align: left;\">The three-character <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO code<\/a> for the currency that was used when settling the payment.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Payable (SC)<\/td>\n<td style=\"text-align: left;\">Fixed point number<\/td>\n<td style=\"text-align: left;\">The amount (in Settlement Currency) debited or credited on the Payable accounting register. This will be paid out to your bank account.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Commission (SC)<\/td>\n<td style=\"text-align: left;\">Fixed point number<\/td>\n<td style=\"text-align: left;\">The commission fee that was withheld by the acquirer (in Settlement Currency)<br>If the acquirer provides the transaction information at the interchange level, Adyen will split the commission into the Markup, Scheme Fees and Interchange registers instead.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Markup (SC)<\/td>\n<td style=\"text-align: left;\">Fixed point number<\/td>\n<td style=\"text-align: left;\">The fee charged by the acquiring bank (in Settlement Currency).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Scheme Fees (SC)<\/td>\n<td style=\"text-align: left;\">Fixed point number<\/td>\n<td style=\"text-align: left;\">The fee charged by, for example, Visa or Mastercard (in Settlement Currency).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Interchange (SC)<\/td>\n<td style=\"text-align: left;\">Fixed point number<\/td>\n<td style=\"text-align: left;\">The fee charged by the issuing bank (in Settlement Currency).<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Processing Fee Currency<\/td>\n<td style=\"text-align: left;\">Alpha Text (3-character limit)<\/td>\n<td style=\"text-align: left;\">The three-character <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO code<\/a> for the currency in which the processing (or gateway) fee is charged.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Processing Fee (FC)<\/td>\n<td style=\"text-align: left;\">Fixed point number<\/td>\n<td style=\"text-align: left;\">The amount (in Processing Fee Currency) charged on the Processing Fee accounting register.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ol>\n<h2>2. Download IPAR or PAR<\/h2>\n<p>Now that you have a custom column configuration for the Payment Accounting Report, you can download a report for the dates you want to calculate your payment costs.<\/p>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, select the <strong>Merchant<\/strong> level.<\/li>\n<li>Select <strong>Reports<\/strong> &gt; <strong>Finance<\/strong>.<\/li>\n<li>Locate the report you want to generate, and select <strong>Generate<\/strong>.<\/li>\n<li>Download the <a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/\">Payment Accounting Report<\/a> or generate an <a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\/#interactive-payment-accounting-report\">Interactive Payment Account Report<\/a> for the period of time you want to create your Merchant Statement Report.<\/li>\n<\/ol>\n<h2>3. Create new Main Amount column<\/h2>\n<p>This new column represents the gross amount of the transaction in the settlement currency. The column is created by aggregating the net settled amount and the transaction costs.<\/p>\n<ol>\n<li>Create a new column, <strong>Main Amount (SC)<\/strong>, using the following formula from existing columns:<br \/>\n<strong>Main Amount (SC)<\/strong> = <strong>Payable (SC)<\/strong> + <strong>Commission (SC)<\/strong> + <strong>Scheme Fees (SC)<\/strong> + <strong>Interchange (SC)<\/strong> + <strong>Markup (SC)<\/strong><\/li>\n<\/ol>\n<h2>4. (Optional) Download an <strong>Exchange rate<\/strong> report<\/h2>\n<p>If you transact with multiple currencies, download the <strong>Exchange rate<\/strong> report for the respective days you want to calculate total fees. These dates should match the <strong>Booking Date<\/strong> entries in your IPAR or PAR report.<\/p>\n<p>To generate an <strong>Exchange rate<\/strong> report:<\/p>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, select <strong>Reports<\/strong> &gt; <strong>Finance<\/strong>.<\/li>\n<li>Locate the <strong>Exchange rate<\/strong> report, and select <strong>Generate<\/strong>.<br \/>\nYou have the option to generate the <strong>Exchange rate<\/strong> report automatically (daily), or manually, by selecting a date.<\/li>\n<\/ol>\n<h2>5. (Optional) Convert Settlement Currency to Base Currency<\/h2>\n<p>For each <strong>Booking Date<\/strong> in the Payment Accounting Report, use the <strong>Exchange rate<\/strong> report from that same date to convert the following values for each Settlement Currency <strong><em>Column Name<\/em> (SC)<\/strong> or <strong>Processing Fee Currency (FC)<\/strong> column to a new Base Currency Column Name (BC) column.<\/p>\n<ul>\n<li><strong>Commission (SC)<\/strong> &gt; <strong>Commission (BC)<\/strong><\/li>\n<li><strong>Scheme Fees (SC)<\/strong> &gt; <strong>Scheme Fees (BC)<\/strong><\/li>\n<li><strong>Interchange (SC)<\/strong> &gt; <strong>Interchange (BC)<\/strong><\/li>\n<li><strong>Markup (SC)<\/strong> &gt; <strong>Markup (BC)<\/strong><\/li>\n<li><strong>Processing Fee (FC)<\/strong> &gt; <strong>Processing Fee (BC)<\/strong><\/li>\n<li><strong>Main Amount (SC)<\/strong> &gt; <strong>Main Amount (BC)<\/strong><\/li>\n<\/ul>\n<p>To do this<\/p>\n<ol>\n<li>Locate the currency conversion pairs in the <strong>Exchange rate<\/strong> report that you want to use for conversion.<\/li>\n<li>\n<p>Multiply all Settlement Currency <strong><em>Column Name<\/em> (SC)<\/strong> columns, and the <strong>Processing Fee (FC)<\/strong> column by the value found in the <strong>Exchange rate<\/strong> column to determine the Base Currency <strong><em>Column Name<\/em> (BC)<\/strong> result.<br \/>\nBased on your integration type, use the following rate column in the <strong>Exchange rate<\/strong> report to convert the values:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Integration type<\/th>\n<th style=\"text-align: left;\">Column<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Payments only<\/td>\n<td style=\"text-align: left;\">Exchange Rate<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Platform\/Marketplace<\/td>\n<td style=\"text-align: left;\">Exchange Rate (Platform Settlement)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ol>\n<h2>6. Create pivot table to aggregate costs<\/h2>\n<p>Create a pivot table to aggregate all costs over a single payment's <strong>PSP Reference<\/strong>.<\/p>\n<ol>\n<li>Add <strong>Psp Reference<\/strong> for the row dimension.<\/li>\n<li>Add <strong>Payment Method<\/strong> for the column dimension.<\/li>\n<li>\n<p>Add the following <strong>Values<\/strong>:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Single currency<br>Use these values when transacting in a single currency.<br>(SC) = Settlement Currency<\/th>\n<th style=\"text-align: left;\">Multiple currencies<br>Use these values when transacting in multiple currencies.<br>(BC) = Base Currency<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Commission (SC)<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Commission (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Scheme Fees (SC)<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Scheme Fees (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Interchange (SC)<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Interchange (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Markup (SC)<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Markup (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Processing Fee (FC)<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Processing Fee (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ol>\n<h2>7. Determine aggregate transaction costs<\/h2>\n<p>Run the following formulas to determine different aggregate transaction cost details from the pivot for each <strong>Payment Method<\/strong>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Desired result<\/th>\n<th style=\"text-align: left;\">Single currency formula<\/br>Use these formulas when transacting in a single currency.<\/br>(SC) = Settlement Currency<\/th>\n<th style=\"text-align: left;\">Multiple currency formula<\/br>Use these formulas when transacting in multiple currencies.<\/br>(BC) = Base Currency<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Main Amount total<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Interchange total<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Interchange (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Interchange (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Interchange total rate<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Interchange (SC)<\/strong> \/ Sum of <strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Interchange (BC)<\/strong> \/ Sum of <strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Scheme Fees total<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Scheme Fees (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Scheme Fees (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Scheme Fees total rate<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Scheme Fees (SC)<\/strong> \/ Sum of <strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Scheme Fees (BC)<\/strong> \/ Sum of <strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Markup total<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Markup (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Markup (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Markup total rate<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Markup (SC)<\/strong> \/ Sum of <strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Markup (BC)<\/strong> \/ Sum of <strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Commission total<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Commission (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Commission (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Commission total rate<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Commission (SC)<\/strong> \/ Sum of <strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Commission (BC)<\/strong> \/ Sum of <strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Processing Fee total<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Processing Fee (FC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Processing Fee (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Processing Fee total rate<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Processing Fee (FC)<\/strong> \/ Sum of <strong>Main Amount (SC)<\/strong><\/td>\n<td style=\"text-align: left;\">Sum of <strong>Processing Fee (BC)<\/strong> \/ Sum of <strong>Main Amount (BC)<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Total Cost of Payment<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Interchange total<\/strong> + <strong>Scheme Fees total<\/strong> + <strong>Markup total<\/strong> + <strong>Commission total<\/strong> + <strong>Processing Fee total<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Interchange total<\/strong> + <strong>Scheme Fees total<\/strong> + <strong>Markup total<\/strong> + <strong>Commission total<\/strong> + <strong>Processing Fee total<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Effective Merchant Discount Rate<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Total Cost of Payment<\/strong> \/ <strong>Main Amount total<\/strong><\/td>\n<td style=\"text-align: left;\"><strong>Total Cost of Payment<\/strong> \/ <strong>Main Amount total<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Example report<\/h2>\n<p>The following files show an example of an <strong>Exchange rate<\/strong> report for April 24, 2025 (in .csv format), and a sample <strong>Merchant Statement Report<\/strong> (in .xlsx format) file with new columns added and currency conversions applied.<\/p>\n<ul>\n<li><a href=\"\/pt\/reporting\/merchant-statements-ccc\/exchange_rate_report_2025_04_24.csv\">Exchange rate report, April 24, 2025<\/a><\/li>\n<li><a href=\"\/pt\/reporting\/merchant-statements-ccc\/SAMPLE_Canada_Code_Of_Conduct_Merchant_Statements_Report.xlsx\">Sample Merchant Statement Report<\/a><\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/reporting\/merchant-statements-ccc","articleFields":{"description":"Create a merchant report that shows the aggregate fees and effective merchant discount rate of each payment method.","feedback_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/reporting\/merchant-statements-ccc","title":"Canada Code of Conduct - Merchant statements","content":"As a registered Payment Service Provider in Canada, Adyen must comply with the requirements of the Code of Conduct for the Payment Card Industry in Canada, referred to as the Canada Code of Conduct. The Canada Code of Conduct aims to improve transparency around the total fees (interchange fee, scheme fee, acquirer fees) paid per Payment Card Network Operator (PCNO).\nThis guide helps you assess the total cost of payment for each payment method. The instructions show how to compute your effective merchant discount rates per PCNO. The effective merchant discount rate is the total cost, divided by the total sales volume, for each payment method. To determine these costs, you use the Payment Accounting Report (PAR) or the Interactive Payment Accounting Report (IPAR).\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nAny integration with Adyen.\n\n\nAPI credential roles\nMake sure that you have the following webservice role:Report service user\n\n\nCustomer Area roles\nMake sure that you have one of the following roles to configure report columns: Merchant adminMerchant reportMerchant financialMerchant POS Report roleMake sure that you have one of the following roles to generate and download reports: Merchant report\n\n\nWebhooks\nIf you want to create your report from an automatically generated Payment Accounting Report instead of the Interactive Payment Accounting Report, subscribe to the following webhook: Standard Webhook\n\n\n\nHow it works\nTo generate a Merchant Statement Report to determine the total cost of payment:\n\nConfigure columns for one of the following reports:\n\nInteractive Payment Account Report (IPAR)\nPayment Accounting Report (PAR)\n\nGenerate and download an IPAR or PAR with the new column structure.\nCreate a new Main Amount (SC) column whose value is the gross amount of the transaction.\n(Optional) If you transact in multiple currencies, download an Exchange rate report.\n(Optional) If you transact in multiple currencies, convert all Settlement Currency Column Name (SC) and Processing Fee (FC) column values to new Base Currency Column Name (BC) column values.\nCreate a pivot table to aggregate all costs per payment's PSP Reference.\nRun formulas to determine different aggregate transaction costs over your report's time period to determine total transaction costs by payment method.\n\n1. Configure report columns\nTo make this report easier to work with, we suggest that you configure the columns of the Payment Accounting Report to contain only the columns needed to calculate your costs.\n\nIn your Customer Area, select Settings &gt; Report columns.\nFind the Payment Accounting Report you want to use as your base for your payment cost report and select Configure.\n\nPayment accounting\nInteractive payment accounting\n\n\nSelect the following columns for your report, and select Save configuration:\n\n\n\nColumn\nType\nDescription\n\n\n\n\nPsp Reference\nUnicode Text (16-character)\nAdyen's 16-character unique reference associated with the transaction\/the request.\u00a0This value is globally unique; quote it when communicating with us about this request.\n\n\nPayment Method\nUnicode Text (50-character)\nThe payment method used for the transaction.  For example: visa, mc, amex.\n\n\nBooking Date\nDate field + Time field\nThe timestamp indicating when the event was entered into Adyen's accounting system. The format is YYYY-MM-DD HH:MM:SS.  For example: 2021-07-26 19:58:55.\n\n\nRecord Type\nUnicode Text (50-character)\nThe accounting record type.For a list of record types, see Record types.\n\n\nSettlement Currency\nAlpha Text (3-character limit)\nThe three-character ISO code for the currency that was used when settling the payment.\n\n\nPayable (SC)\nFixed point number\nThe amount (in Settlement Currency) debited or credited on the Payable accounting register. This will be paid out to your bank account.\n\n\nCommission (SC)\nFixed point number\nThe commission fee that was withheld by the acquirer (in Settlement Currency)If the acquirer provides the transaction information at the interchange level, Adyen will split the commission into the Markup, Scheme Fees and Interchange registers instead.\n\n\nMarkup (SC)\nFixed point number\nThe fee charged by the acquiring bank (in Settlement Currency).\n\n\nScheme Fees (SC)\nFixed point number\nThe fee charged by, for example, Visa or Mastercard (in Settlement Currency).\n\n\nInterchange (SC)\nFixed point number\nThe fee charged by the issuing bank (in Settlement Currency).\n\n\nProcessing Fee Currency\nAlpha Text (3-character limit)\nThe three-character ISO code for the currency in which the processing (or gateway) fee is charged.\n\n\nProcessing Fee (FC)\nFixed point number\nThe amount (in Processing Fee Currency) charged on the Processing Fee accounting register.\n\n\n\n\n\n2. Download IPAR or PAR\nNow that you have a custom column configuration for the Payment Accounting Report, you can download a report for the dates you want to calculate your payment costs.\n\nIn your Customer Area, select the Merchant level.\nSelect Reports &gt; Finance.\nLocate the report you want to generate, and select Generate.\nDownload the Payment Accounting Report or generate an Interactive Payment Account Report for the period of time you want to create your Merchant Statement Report.\n\n3. Create new Main Amount column\nThis new column represents the gross amount of the transaction in the settlement currency. The column is created by aggregating the net settled amount and the transaction costs.\n\nCreate a new column, Main Amount (SC), using the following formula from existing columns:\nMain Amount (SC) = Payable (SC) + Commission (SC) + Scheme Fees (SC) + Interchange (SC) + Markup (SC)\n\n4. (Optional) Download an Exchange rate report\nIf you transact with multiple currencies, download the Exchange rate report for the respective days you want to calculate total fees. These dates should match the Booking Date entries in your IPAR or PAR report.\nTo generate an Exchange rate report:\n\nIn your Customer Area, select Reports &gt; Finance.\nLocate the Exchange rate report, and select Generate.\nYou have the option to generate the Exchange rate report automatically (daily), or manually, by selecting a date.\n\n5. (Optional) Convert Settlement Currency to Base Currency\nFor each Booking Date in the Payment Accounting Report, use the Exchange rate report from that same date to convert the following values for each Settlement Currency Column Name (SC) or Processing Fee Currency (FC) column to a new Base Currency Column Name (BC) column.\n\nCommission (SC) &gt; Commission (BC)\nScheme Fees (SC) &gt; Scheme Fees (BC)\nInterchange (SC) &gt; Interchange (BC)\nMarkup (SC) &gt; Markup (BC)\nProcessing Fee (FC) &gt; Processing Fee (BC)\nMain Amount (SC) &gt; Main Amount (BC)\n\nTo do this\n\nLocate the currency conversion pairs in the Exchange rate report that you want to use for conversion.\n\nMultiply all Settlement Currency Column Name (SC) columns, and the Processing Fee (FC) column by the value found in the Exchange rate column to determine the Base Currency Column Name (BC) result.\nBased on your integration type, use the following rate column in the Exchange rate report to convert the values:\n\n\n\nIntegration type\nColumn\n\n\n\n\nPayments only\nExchange Rate\n\n\nPlatform\/Marketplace\nExchange Rate (Platform Settlement)\n\n\n\n\n\n6. Create pivot table to aggregate costs\nCreate a pivot table to aggregate all costs over a single payment's PSP Reference.\n\nAdd Psp Reference for the row dimension.\nAdd Payment Method for the column dimension.\n\nAdd the following Values:\n\n\n\nSingle currencyUse these values when transacting in a single currency.(SC) = Settlement Currency\nMultiple currenciesUse these values when transacting in multiple currencies.(BC) = Base Currency\n\n\n\n\nCommission (SC)\nCommission (BC)\n\n\nScheme Fees (SC)\nScheme Fees (BC)\n\n\nInterchange (SC)\nInterchange (BC)\n\n\nMarkup (SC)\nMarkup (BC)\n\n\nProcessing Fee (FC)\nProcessing Fee (BC)\n\n\nMain Amount (SC)\nMain Amount (BC)\n\n\n\n\n\n7. Determine aggregate transaction costs\nRun the following formulas to determine different aggregate transaction cost details from the pivot for each Payment Method.\n\n\n\nDesired result\nSingle currency formulaUse these formulas when transacting in a single currency.(SC) = Settlement Currency\nMultiple currency formulaUse these formulas when transacting in multiple currencies.(BC) = Base Currency\n\n\n\n\nMain Amount total\nSum of Main Amount (SC)\nSum of Main Amount (BC)\n\n\nInterchange total\nSum of Interchange (SC)\nSum of Interchange (BC)\n\n\nInterchange total rate\nSum of Interchange (SC) \/ Sum of Main Amount (SC)\nSum of Interchange (BC) \/ Sum of Main Amount (BC)\n\n\nScheme Fees total\nSum of Scheme Fees (SC)\nSum of Scheme Fees (BC)\n\n\nScheme Fees total rate\nSum of Scheme Fees (SC) \/ Sum of Main Amount (SC)\nSum of Scheme Fees (BC) \/ Sum of Main Amount (BC)\n\n\nMarkup total\nSum of Markup (SC)\nSum of Markup (BC)\n\n\nMarkup total rate\nSum of Markup (SC) \/ Sum of Main Amount (SC)\nSum of Markup (BC) \/ Sum of Main Amount (BC)\n\n\nCommission total\nSum of Commission (SC)\nSum of Commission (BC)\n\n\nCommission total rate\nSum of Commission (SC) \/ Sum of Main Amount (SC)\nSum of Commission (BC) \/ Sum of Main Amount (BC)\n\n\nProcessing Fee total\nSum of Processing Fee (FC)\nSum of Processing Fee (BC)\n\n\nProcessing Fee total rate\nSum of Processing Fee (FC) \/ Sum of Main Amount (SC)\nSum of Processing Fee (BC) \/ Sum of Main Amount (BC)\n\n\nTotal Cost of Payment\nInterchange total + Scheme Fees total + Markup total + Commission total + Processing Fee total\nInterchange total + Scheme Fees total + Markup total + Commission total + Processing Fee total\n\n\nEffective Merchant Discount Rate\nTotal Cost of Payment \/ Main Amount total\nTotal Cost of Payment \/ Main Amount total\n\n\n\nExample report\nThe following files show an example of an Exchange rate report for April 24, 2025 (in .csv format), and a sample Merchant Statement Report (in .xlsx format) file with new columns added and currency conversions applied.\n\nExchange rate report, April 24, 2025\nSample Merchant Statement Report\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Reporting","lvl2":"Canada Code of Conduct - Merchant statements"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/reporting","lvl2":"\/pt\/reporting\/merchant-statements-ccc"},"levels":3,"category":"Reporting","category_color":"green","tags":["Canada","Conduct","Merchant","statements"]},"articleFiles":{"exchange_rate_report_2025_04_24.csv":"<p alt=\"\">exchange_rate_report_2025_04_24.csv<\/p>","SAMPLE_Canada_Code_Of_Conduct_Merchant_Statements_Report.xlsx":"<p alt=\"\">SAMPLE_Canada_Code_Of_Conduct_Merchant_Statements_Report.xlsx<\/p>"}}
