---
title: "PayPal Transactions"
description: "A non-technical ecosystem overview of PayPal Transactions in RevCent, focused on how PayPal payment records connect PayPal Accounts to Sales, Customers, Product Sales, Shipping, Tax, Refunds, PayPal Disputes, Fraud Detection, Metadata, and reporting."
type: "item"
company: "RevCent"
canonical: "https://revcent.com/documentation/markdown/ecosystem/item/PayPalTransaction.md"
relationships:
  - name: "PayPal Account"
    url: "https://revcent.com/documentation/markdown/ecosystem/feature/PayPalAccount.md"
  - name: "PayPal Dispute"
    url: "https://revcent.com/documentation/markdown/ecosystem/item/PayPalDispute.md"
technical_links:
  web_app: "https://kb.revcent.com/en/payments/paypal/transaction"
  api:
    section: "https://revcent.com/docs/api/v2#section-pay_pal_transactions"
    operations:
      - name: "Get PayPal Transactions"
        operation_id: "GetPayPalTransactions"
        operation: "https://revcent.com/docs/api/v2#operation-GetPayPalTransactions"
        schema: "https://revcent.com/documentation/files/api/operation/GetPayPalTransactions.json"
      - name: "Get A PayPal Transaction"
        operation_id: "GetPayPalTransaction"
        operation: "https://revcent.com/docs/api/v2#operation-GetPayPalTransaction"
        schema: "https://revcent.com/documentation/files/api/operation/GetPayPalTransaction.json"
      - name: "Search PayPal Transactions"
        operation_id: "SearchPayPalTransactions"
        operation: "https://revcent.com/docs/api/v2#operation-SearchPayPalTransactions"
        schema: "https://revcent.com/documentation/files/api/operation/SearchPayPalTransactions.json"
  mcp:
    overview: "https://revcent.com/documentation/markdown/mcp/operation/OverviewPayPalTransaction.md"
    operations:
      - name: "Get PayPal Transactions"
        operation_id: "GetPayPalTransactions"
        markdown: "https://revcent.com/documentation/markdown/mcp/operation/GetPayPalTransactions.md"
        available_via_ai: true
      - name: "Get A PayPal Transaction"
        operation_id: "GetPayPalTransaction"
        markdown: "https://revcent.com/documentation/markdown/mcp/operation/GetPayPalTransaction.md"
        available_via_ai: true
      - name: "Search PayPal Transactions"
        operation_id: "SearchPayPalTransactions"
        markdown: "https://revcent.com/documentation/markdown/mcp/operation/SearchPayPalTransactions.md"
        available_via_ai: true
  bigquery_schema: "https://revcent.com/documentation/files/bigquery/dataset.json"
  bigquery_tables:
    - "paypal_transaction"
---

# PayPal Transactions

PayPal Transactions are RevCent item records that represent PayPal payment activity.

A PayPal Transaction is not the same as a PayPal Account. The PayPal Account is the connected PayPal configuration. The PayPal Transaction is the payment-related item created from a PayPal purchase or PayPal payment event.

## Why PayPal Transactions Are an Item

PayPal Transactions are items because each one represents a specific PayPal payment record in RevCent.

A business may configure a PayPal Account once, but many PayPal Transactions can be created over time as customers pay with PayPal.

The simplest distinction is:

- PayPal Account: the reusable PayPal connection.
- PayPal Transaction: an individual PayPal payment record.
- PayPal Dispute: an individual PayPal dispute connected to PayPal activity.

## Where PayPal Transactions Fit in RevCent

PayPal Transactions sit in the payment history layer of RevCent.

They help connect PayPal payments to the rest of the commerce graph, including Sales, Customers, Product Sales, Shipping, Tax, Campaigns, Shops, Pending Refunds, PayPal Disputes, Metadata, and Fraud Detection.

In the web app, PayPal Transactions can be viewed from the PayPal Transactions area under Payments. A user can also find a PayPal Transaction through search or by opening a transaction from the list.

PayPal Transactions can also be retrieved or searched programmatically through the API and MCP/AI when a user needs automated lookup, support context, or reporting preparation.

## Core Business Purpose

The purpose of a PayPal Transaction is to make a PayPal payment understandable inside RevCent.

A PayPal Transaction helps answer questions such as:

- Which PayPal payment belongs to this Sale?
- Which PayPal Account was involved?
- Which Customer paid with PayPal?
- Which Campaign or Shop generated the PayPal payment?
- Which Product Sales, Shipping records, and Tax records are connected?
- Was any part of the PayPal payment refunded?
- Is there a PayPal Dispute related to this payment?
- Is there Fraud Detection context for the transaction?

Without PayPal Transactions, PayPal payment activity would be harder to connect to the rest of the RevCent ecosystem.

## How PayPal Transactions Are Created

A PayPal Transaction is created when RevCent records a Sale paid with PayPal.

In a typical PayPal checkout flow, the customer completes payment through PayPal, PayPal provides a transaction identifier, and RevCent uses that payment context to create or connect the Sale and PayPal Transaction.

The important ecosystem idea is:

- PayPal provides the payment event.
- RevCent records the customer purchase as a Sale.
- RevCent connects the PayPal payment to the Sale as a PayPal Transaction.
- Related records such as Customer, Product Sales, Shipping, Tax, and Metadata can then connect around the same purchase.

## Relationship to PayPal Accounts

Every PayPal Transaction should be understood in relation to a PayPal Account.

The PayPal Account is the feature that connects RevCent to PayPal. The PayPal Transaction is one of the item records that can be created or organized through that connection.

The PayPal Account relationship helps RevCent keep PayPal payment activity organized by account, campaign, shop, and business context.

## Relationship to Sales and Customers

A PayPal Transaction is usually connected to a Sale because it represents PayPal payment activity for a customer purchase.

The Sale tells the broader purchase story. The PayPal Transaction tells the PayPal payment part of that story.

Together, these records help RevCent connect payment activity to customer history, support workflows, revenue tracking, refunds, shipping, tax, and disputes.

## Relationship to Product Sales, Shipping, and Tax

The PayPal Transaction detail page can display related entities such as the Sale, products sold, Shipping, Tax, and other related records.

This is important because a payment alone does not explain the whole purchase. The surrounding RevCent records show what the customer bought, what shipped, what tax was charged, what was refunded, and what support or dispute activity may exist.

Common relationship paths include:

- PayPal Transaction → Sale: the purchase connected to the PayPal payment.
- PayPal Transaction → Product Sales: the specific products purchased.
- PayPal Transaction → Shipping: fulfillment and tracking context.
- PayPal Transaction → Tax: tax records tied to the purchase.
- PayPal Transaction → Pending Refunds: refund records connected to the payment context.
- PayPal Transaction → Metadata: custom context added for search, reporting, or automation.

## Refund Context

In the web app, a PayPal Transaction is not the record a user refunds directly.

Refunds should be issued through the related RevCent entity, such as the Sale, Product Sale, Shipping, or Tax record. This keeps reporting and item-level revenue context accurate.

At the ecosystem level, the important idea is that refunds should stay connected to the item being refunded, while the PayPal Transaction provides the PayPal payment context behind that refund.

## Relationship to PayPal Disputes

PayPal Disputes can be related to PayPal Transactions.

This relationship helps RevCent connect dispute activity back to the payment, Sale, Customer, Campaign, Shop, Product Sales, Shipping, and other records that explain the customer purchase.

For support and risk teams, this connection is valuable because a dispute is easier to understand when it is tied to the full commerce history.

## Relationship to Fraud Detection

A PayPal Transaction can be marked as fraud in the web app, creating Fraud Detection context.

Once a Fraud Detection is created for a PayPal Transaction, it becomes part of the risk and support history around that payment. This can help teams track suspicious activity, customer issues, and dispute patterns.

## API, MCP, and AI Context

The API and MCP/AI links exist so PayPal Transactions can participate in automated lookup, support, and analysis workflows.

At the ecosystem level, this means PayPal Transactions can be found, reviewed, and connected to related records by approved automation. The important concept is that PayPal Transactions are part of RevCent's connected payment graph, not isolated payment IDs.

## BigQuery Reporting and Relationship Visibility

The `paypal_transaction` BigQuery table represents PayPal Transaction records for reporting and relationship analysis.

For ecosystem understanding, the most important use of this table is that it shows how PayPal Transactions connect to other RevCent records, including PayPal Accounts, Sales, Customers, Product Sales, Shipping, Tax, Pending Refunds, Campaigns, Shops, and Metadata.

This supports business-level reporting such as:

- PayPal revenue by account, campaign, or shop.
- PayPal refund visibility by customer or product.
- PayPal transaction volume over time.
- PayPal purchase activity connected to Sales and Customers.
- PayPal dispute exposure connected to transaction history.
- PayPal activity across storefronts or brands.

BigQuery should be treated here as the reporting and relationship layer, not as a place to document technical schemas or query examples.

## Ecosystem Relationship Summary

PayPal Transactions connect to the RevCent ecosystem like this:

- PayPal Transaction → PayPal Account: the PayPal account connection behind the payment.
- PayPal Transaction → Sale: the customer purchase connected to the PayPal payment.
- PayPal Transaction → Customer: the buyer associated with the payment.
- PayPal Transaction → Product Sales: the products purchased.
- PayPal Transaction → Shipping: fulfillment and tracking context.
- PayPal Transaction → Tax: tax context for the purchase.
- PayPal Transaction → Pending Refunds: refund activity tied to related records.
- PayPal Transaction → PayPal Dispute: dispute activity connected to the PayPal payment.
- PayPal Transaction → Fraud Detection: risk context when a transaction is marked as fraud.
- PayPal Transaction → BigQuery: reporting and relationship visibility.

## Summary

PayPal Transactions are RevCent's item records for PayPal payment activity.

They help connect PayPal payments to PayPal Accounts, Sales, Customers, Product Sales, Shipping, Tax, Refunds, Disputes, Fraud Detection, Metadata, automation, and BigQuery reporting. Their main ecosystem value is that they make PayPal payments part of the same connected RevCent graph as the rest of the business.


---
Document Parent Directory
* [Items](https://revcent.com/documentation/markdown/ecosystem/item/index.md) - Non-technical markdown documentation for items within the RevCent ecosystem. An item is an entity that is spawned as a result of a feature or operation conducted within the RevCent ecosystem.