On this page
No Headings
Last updated: July 10, 2026
This report provides details about the revenue share that a partner earns from each transaction and the corresponding payout that settled to your PayPal or bank account. The report supports reconciliation and enables you to validate each transaction's contribution to your total revenue share payout for a specific period.
You can access this report through PayPal's SFTP server. For more information, see Access SFTP reports.
Check out this video on reconciling revenue share using the Revenue Share Transactions report:
Sample reports are available for each revenue share model.
| Revenue share model | Description | Sample report |
|---|---|---|
| Net TPV | PayPal shares a portion of Total Payments Volume (TPV) with the partner. | Download sample |
| Net Revenue | PayPal shares a portion of net revenue earned with the partner after deducting costs (for example, interchange and network fees) and losses (for example, chargebacks and negative balances). | Download sample |
| Buy-Sell | PayPal collects the transaction fee (sell rate) from the merchant and retains the platform fee (buy rate). For interchange plus plus (IC++) use cases, processing costs (interchange and assessment) are also passed to the partner. | Download sample |
For tips on reconciling your Revenue Share Transactions report data, see Reconciliations.
Before using this report, review the following requirements and considerations:
-1000.00 for refunds).The file name of the Revenue Share Transactions report follows this convention:
${encryptedSubscriptionId}-{NodeIdentifier}-{subfamily}-{templateName}-{dateCadence}-{fileNumber}-{totalFile}-{genDateTime}.{extension}The templateName field identifies the revenue share model: REVSHARE_TXN_REPORT_nTPV, REVSHARE_TXN_REPORT_NREV, or REVSHARE_TXN_REPORT_BuySell.
For more information, see Terminololgy.
The following examples illustrate how the file name convention applies to different report files.
Each report includes the following sections. Within each section, rows are categorized by type, which is indicated in the first column of each row. The following table lists the valid row types and the sections that describe the data for that row type.
| Code | Description |
|---|---|
RH | Report header |
RS | Report summary |
RD | Report details |
RF | Report footer |
The report header contains metadata about the report, including the report name, status, date range, generation time, account hierarchy, and time zone.
| Position | Column name | Required | Data type | Description |
|---|---|---|---|---|
| 1 | RH | Required | Static, 2 characters | Indicates that this row contains report header data. |
| 2 | Report Name | Required | Varchar(256) | The name of the report: REVSHARE_TXN_REPORT_nTPV (Net TPV), REVSHARE_TXN_REPORT_NREV (Net Revenue), or REVSHARE_TXN_REPORT_BuySell (Buy-Sell) |
| 3 | Report Status | Required | Varchar | The report generation status: Success or Error |
| 4 | Report Start Date and Time | Required | Date-time | The start date and time for the data in the report, in this format: YYYY/MM/DD HH:MM:SS offset. offset is the 5-character signed offset from GMT, for example +0800. |
| 5 | Report End Date and Time | Required | Date-time | The end date and time for the data in the report, in this format: YYYY/MM/DD HH:MM:SS offset. offset is the 5-character signed offset from GMT, for example +0800. |
| 6 | Report Generation Date and Time | Required | Date-time | The date and time when the report file was generated, in this format: YYYY/MM/DD HH:MM:SS offset. offset is the 5-character signed offset from GMT, for example +0800. |
| 7 | Hierarchy | Required | Varchar(256) | The encrypted PayPal account number |
| 8 | Timezone | Optional | Varchar(256) | The time zone of the report |
The report summary provides payout-level details, including payout IDs, period, amount, currency, payment instrument, and program name.
| Position | Column name | Required | Data type | Description |
|---|---|---|---|---|
| 1 | RS | Required | Static, 2 characters | The row type (RS) |
| 2 | Record ID | Optional | Varchar(256) | The PayPal-generated unique identifier for the payout transaction |
| 3 | Transfer ID | Optional | Varchar(256) | The unique, external reference number for the payout transaction |
| 4 | Payout Period Start Date | Optional | Date-time | The start date of the period for which the revenue share payout is calculated, in this format: YYYY-MM-DD HH:MM:SS offset. offset is the 5-character signed offset from GMT, for example +0800. |
| 5 | Payout Period End Date | Optional | Date-time | The end date of the period for which the revenue share payout is calculated, in this format: YYYY-MM-DD HH:MM:SS offset. offset is the 5-character signed offset from GMT, for example +0800. |
| 6 | Timezone | Optional | Varchar(256) | The time zone of the user. Transactions included in the payout are based on this time zone. |
| 7 | Payout Amount | Optional | Numeric(23,2) | The total amount disbursed to your account for this payout |
| 8 | Payout Currency | Optional | 3-character currency code | The currency in which the payout is processed. See PayPal-supported currencies for possible values. |
| 9 | Payout Instrument | Optional | Varchar(256) | The payment instrument to which the payout was made |
| 10 | Account Number | Optional | Varchar(256) | The account number that is associated with the payment instrument |
| 11 | Revenue Share Program | Optional | Varchar(256) | The revenue share program name that is defined in PayPal for configuring the revenue share arrangement |
The report details section contains one row for each transaction and includes relevant information about the transaction, such as merchant account, region, type, integration product, transaction IDs, amounts, currencies, payment methods, fee breakdowns, and revenue share calculations.
| Position | Column name | Required | Data type | Description |
|---|---|---|---|---|
| 1 | RD | Required | Static, 2 characters | The row type (RD) |
| 2 | Merchant Account ID | Required | Varchar(256) | The encrypted account number of the merchant |
| 3 | Merchant Region | Required | Varchar(256) | The merchant's country code of residence. For a list of possible values, see the Market Code Table. |
| 4 | Merchant Type | Optional | Varchar(256) | For the Net TPV model, indicates whether the merchant is classified as New or Existing for revenue share eligibility. Not applicable for the Buy-Sell model. |
| 5 | Integration Product | Optional | Varchar(256) | For the Net TPV and Net Revenue models, the integration product used to process the transaction with PayPal. For more information, seeTerminololgy. Not applicable for the Buy-Sell model. |
| 6 | Integration Sub Product | Optional | Varchar(256) | Not applicable for the Net TPV or Buy-Sell models |
| 7 | Integration Identifier | Optional | Varchar(256) | The BN code from PayPal that is associated with the transaction |
| 8 | Record ID | Required | Varchar(256) | The PayPal-generated unique identifier for this transaction |
| 9 | Related Record ID | Required | Varchar(256) | The transaction ID for the immediate parent transaction |
| 10 | Record Type | Required | Varchar(256) | The type of transaction. For a list of possible values, see Terminololgy. |
| 11 | Record Subtype | Optional | Varchar(256) | The subtype of the transaction. For a list of possible values, see Terminololgy. |
| 12 | Created At | Required | Date-time | The date and time when the transaction was initiated, in this format: YYYY-MM-DD HH:MM:SS offset. offset is the 5-character signed offset from GMT, for example +0800. |
| 13 | Gross Transaction Amount | Required | Numeric(23,2) | The total amount of the transaction before deducting fees |
| 14 | Transaction Currency | Required | 3-character currency code | The currency of the transaction. |
| 15 | Payment Method | Optional | Varchar(256) | The method of payment that was used to process the transaction. For more information, see Terminololgy. |
| 16 | Payment Method Type | Optional | Varchar(256) | The specific tender that was used to process the transaction. For more information, see Terminololgy. |
| 17 | Invoice ID | Optional | Varchar(256) | The invoice ID that was passed at the time of the transaction |
| 18 | Custom Field | Optional | Varchar(256) | A field for custom data |
| 19 | Merchant Pricing Model | Optional | Varchar(256) | For the Buy-Sell model, this value specifies the pricing structure that was applied when charging the merchant: FLAT (fixed fee per transaction) or IC_PLUS (interchange pass-through fee plus a fixed markup fee). Not applicable for the Net TPV model. |
| 20 | Transaction Meta Data | Optional | Varchar(256) | Additional transaction details in JSON format, primarily applicable for the Buy-Sell model. For more information, see the transaction meta data. |
| 21 | Revshare Eligible | Required | Varchar(256) | Indicates whether the transaction qualifies for revenue share: YES or NO |
| 22 | Revshare Model | Optional | Varchar(256) | The primary revenue share model that was applied to the transaction: NET_TPV, NET_REVENUE, or BUY_SELL |
| 23 | Total Processing Fee | Optional | Varchar(256) | For the Net Revenue model, the fees charged to process the transaction. For the Buy-Sell model, the total fee collected from the merchant in transaction currency for revenue-share-eligible fee components. Not applicable for the Net TPV model. For more information, see the Attribute reference. |
| 24 | Total Processing Cost | Optional | Varchar(256) | For the Net Revenue model, the costs that were associated with processing the transaction. For the Buy-Sell model, the total processing costs (interchange, assessments, and so on) in the transaction currency. Not applicable for the Net TPV model. For more information, see the Attribute reference. |
| 25 | Processing Losses | Optional | Varchar(256) | For the Net Revenue model, losses that were incurred as part of the transaction (for example, chargebacks and bank returns). Not applicable for the Net TPV or Buy-Sell models. For more information, see the Attribute reference. |
| 26 | Platform Fee | Optional | Varchar(256) | For the Net Revenue model, the fees that PayPal charged as part of the PayPal markup. For the Buy-Sell model, the portion of the processing fee that PayPal retained in the transaction currency for the revenue-share-eligible components. Not applicable for the Net TPV model. |
| 27 | Partner Revshare | Optional | Numeric(23,2) | The revenue share that was earned from the transaction in the record currency, rounded to 2 decimal places |
| 28 | Fee Details | Optional | Varchar(256) | A JSON object that breaks down revenue share from eligible transaction and value-added-service components, with detailed fee and cost sub-components. For more information, see the Attribute reference. |
| 29 | Payout Currency | Required | 3-character currency code | The currency of the revenue share payout. |
| 30 | Revshare Payout | Required | Numeric(23,2) | The revenue share that was earned from the transaction in payout currency, rounded to 6 decimal places |
| 31 | Transfer ID | Required | Varchar(256) | The unique external reference number that was assigned to the payout transaction |
| 32 | Revshare Remarks | Optional | Varchar(256) | Additional remarks about the revenue share for this transaction |
| 33 | Payment Channel | Optional | Varchar(256) | The channel through which the payment transaction was processed. |
| 34 | Fee Period Start | Optional | YYYY-MM-DD | The start date of the period in which the fee-incurring transaction took place. |
| 35 | Fee Period End | Optional | YYYY-MM-DD | The end date of the period in which the fee-incurring transaction took place. |
The report footer indicates the file number and total record count for the file.
| Position | Column name | Required | Data type | Description |
|---|---|---|---|---|
| 1 | RF | Required | Static, 2 characters | Indicates that this row contains report footer data. |
| 2 | File Number | Required | Numeric(23,2) | The current file number. This corresponds to the file number in the file naming convention. |
| 3 | Total Records | Required | Numeric(23,2) | The total number of transactions that the report details (RD) section includes. This field appears only when transactional details are present. |
| 4 | Total Files | Required | Numeric(23,2) | The total number of files generated for the report. |
Use the following table to reconcile payouts against your bank statement, PayPal account, and transaction-level data.
| Use case | How to reconcile |
|---|---|
| Trace a revenue share payout in your bank statement or PayPal account | Match the Transfer ID in the report summary section to the payout in your bank or PayPal account. |
| Reconcile payouts with contributing transactions | For each Transfer ID, the Payout Amount in the report summary section must equal the sum of REVSHARE_PAYOUT (in PAYOUT_CURRENCY) across all contributing transactions in the report details section. |
| Calculate revenue share per transaction | Revenue share is calculated differently by model: Net TPV: Revenue share = TPV * Margin Net Revenue: Revenue share = (Transaction fee - Processing cost - Processing losses) * Margin Buy-Sell: Revenue share = Transaction fee - Platform fee - Processing costs (if applicable) |
The following examples show the JSON objects that are returned in the FEE_DETAILS and TRANSACTION_META_DATA columns of the report details section with examples.
The following examples show the FEE_DETAILS JSON objects for transactions that are eligible for each revenue share model. The revshare_model parameter indicates which revenue share model was applied to the transaction, and the partner_revshare parameter indicates the revenue share amount that was earned from the transaction in the record currency. The JSON object also includes a breakdown of the various fee components, processing costs, and losses that were incurred for this transaction, depending on the revenue share model.
The following table describes the parameters in the FEE_DETAILS JSON object.
| Parameter | Data type | Description |
|---|---|---|
revshare_model | Varchar(256) | The primary revenue share model applied to the transaction. For example, the revshare_model for the Net Revenue model is net_revenue. |
revshare_rate | Numeric(23,2) | The revenue share rate applied to net revenue per transaction, expressed as a decimal. |
partner_revshare | Numeric(23,2) | The revenue share earned from the transaction in the record currency, rounded to 2 decimal places. |
platform_fee | Numeric(23,2) | Fees charged by PayPal to meet the costs associated with processing the transaction, rounded to 2 decimal places. |
processing_losses | Numeric(23,2) | Any losses incurred due to chargebacks or bank returns, rounded to 2 decimal places. |
processing_fee | Varchar(256) (JSON object) | A JSON object providing a breakdown of fee components charged to process the transaction. For standard transactions, includes the standard fee charged by PayPal. For IC++ card transactions, also includes interchange and assessment fees charged by processors. |
processing_cost | Varchar(256) (JSON object) | A JSON object providing a breakdown of costs associated with the transaction, such as interchange and assessment charges. Each fee or cost type includes a total amount and fixed and variable components. |
value_added_services | Varchar(256) (JSON object) | Fees charged as part of value-added services opted into by the merchant, such as foreign exchange or fraud protection. Each fee or cost type includes a total amount and fixed and variable components. |
The TRANSACTION_META_DATA JSON object provides FX details for currency conversion transactions.
{"fx_details": {"base_transaction_amount": -160.75,"transaction_currency": "MXN"}}The following table describes the parameters in the TRANSACTION_META_DATA JSON object.
| Parameter | Description |
|---|---|
base_transaction_amount | The base amount on which buy and sell rates or markups are applied. |
transaction_currency | The currency of the base transaction amount in which buy and sell rates or markups are applied. |