Open Collective Docs
Go back to Open Collective
  • WELCOME
  • Welcome
  • Why Open Collective?
    • Why Open Collective?
    • How Open Collective Works
    • Features
    • Pricing
    • Fiscal Host Documentation
  • Getting Started
    • Getting Started
    • Explore
    • Setting up your Account
    • Editing your Profile Page
    • Customizing your Page Layout
    • Adding and Removing Team Members
    • Your Dashboard
    • Understanding Contributions
    • Understanding Expenses
    • Tracking an Expense
    • Creating an Organization
  • Advanced
    • Notifications
    • Preview Features
    • Security For Accounts
      • Logging into your Account
      • Two Factor Authentication
    • Keeping your Community Updated
      • Updates and Contact
      • Conversations
    • Verification
    • Understanding the Ledger
      • Individual Transactions
      • Transaction Pairs, Groups & Perspectives
      • Viewing Transactions
      • Exporting Transactions
      • Fiscal Host Ledger Perspective
      • Contributions in the Ledger
      • Added Funds in the Ledger
      • Expenses in the Ledger
      • Ledger Changelog
    • Exporting Your Data
    • Deleting your Account
  • COLLECTIVES
    • Collectives
    • Creating a Collective
      • Creating Your Policies
      • Security for Collectives
      • Linking Connected Collectives
    • Choosing a Fiscal Host
    • Raising Money
      • Setting Goals and Tiers
      • Customising Thank You Emails
      • Adding Donation Buttons, Badges and Banners
      • Adding Embeds to your Website
      • Creating Custom Fundraising URLs
      • Rejecting and Refunding Financial Contributions
    • Managing Money
      • Budgets
      • Projects
      • Moving money
      • Tagging expenses
    • Spending Money
      • Inviting a Third Party to Submit an Expense
    • Events
    • Changing Fiscal Host
    • Closing a Collective
      • Zero Collective Balance
  • Collective Settings
    • Integrations
  • GIVING TO COLLECTIVES
    • Giving to Collectives
    • Contributing
    • Contributing as a Guest
    • Payment Methods
    • Platform Tips
    • Sharing your Support
    • Making a Recurring Contribution
    • Managing Receipts
    • Giving to Other Collectives
    • Giving as a Company
      • Creating a Fund
      • Bulk Transfers
      • Gift Cards
    • Requesting Refunds
      • Refund Policy
  • EXPENSES AND GETTING PAID
    • Expenses and Getting Paid
    • Submitting Expenses
      • Submitting a Reimbursement
      • Recurring Expenses
      • Multi-Currency Expenses
    • Editing an Expense
    • Payment Processor Fees
    • Getting Paid through Wise
    • Understanding Tax Requirements
  • FISCAL HOSTS
    • Fiscal Hosts
    • Why Become a Fiscal Host?
    • Setting up a Fiscal Host
      • Creating a Fiscal Host
      • Setting your Fiscal Host Fees
      • Fiscal Host Security
      • Fiscal Host Policies
    • Managing your Collectives
      • Hosted Collectives
      • Collective Applications
      • Collecting Local Taxes
      • Vendors
      • Viewing your Host Reports
      • Freezing a Collective
      • Unhosting a Collective
    • Receiving Money as a Host
      • Bank Transfers
      • Stripe
      • Adding Funds Manually
      • Pending Contributions
    • Expense Payment
      • Paying Expenses as a Fiscal Host
      • Understanding Security Checks
      • Asking for Information about Expenses
      • Paying Expenses with Wise
      • Handling Payment Errors Through Wise
    • Processing Refunds
    • Platform Settlements
    • Certified Member
  • INDEPENDENT COLLECTIVES
    • Independent Collectives
    • Creating an Independent Collective
      • Launching an Independent Collective
      • Migrating from Fiscal Host to Independent Collective
      • Migrating from Self-Hosted to Independent Collective
    • Managing Independent Collective Finances
    • Closing an Independent Collective
  • Development
    • API
  • Our Organization
    • About Open Collective
    • Mission And Values
    • Our Team
Powered by GitBook
LogoLogo

Open Collective

  • Open Collective Platform
  • Blog

Support

  • Contact

Community

  • Discord

© 2025 Open Finance Consortium

On this page
  • Transaction Fields
  • Deprecated Fields
  • Transaction Kinds

Was this helpful?

  1. Advanced
  2. Understanding the Ledger

Individual Transactions

All transactions have specific properties assigned to them. Read on to learn about the various fields that describe all transactions on the platform.

Transaction Fields

Name
Description

Expense Type

Describes the kind of expense: invoice, reimbursement, virtual card, settlements and grants.

Kind

Indicates what kind of transaction it is (see Transaction Kinds)

Is Debt

Indicates “true” for platform transactions that represent a debt (PLATFORM_TIP_DEBT & HOST_FEE_SHARE_DEBT).

Amount

The amount of the transaction. Credit transactions have positive values and Debit transactions have negative values.

Currency

The currency in which the transaction was recorded. This is typically the currency in which either the collective or fiscal host manage their funds.

Original Currency Amount

If the transaction currency is different from the host currency, this amount will show the value in which the transaction was initiated. This is a string that includes the original value and currency (eg: 1000 SK).

Account ID

The account to which this transaction is attributed.

Opposite Account ID

The other account related to the transaction.

Host Collective ID

If the collective is hosted by a fiscal host, this references the host (at the time the transaction was created).

Is Refunded

If a transaction was refunded then this field indicates “REFUNDED” otherwise it is empty.

Is Refund

If the transaction is a refund then this field indicates “REFUND” otherwise it is empty.

Refund Transaction ID

If the transaction has been refunded, this will have the transaction ID of the related refund transaction.

Payment Processor

The payment processor associated to the transaction (eg: Stripe, Paypal, Wise, Open Collective, Other).

Payment Method

The payment method associated to the transaction (eg: Credit Card, Balance)

Merchant ID

A reference number provided by the payment processor.

Tax Type

If the transaction is or has related tax information, this indicates the type of tax (VAT/GST).

Tax Rate

If the transaction is or has related tax information, this indicates the applied tax rate.

Tax ID Number

If the transaction is or has related tax information, this indicates the related tax identifier.

Deprecated Fields

These additional fields have been deprecated but may still apply to older transaction records:

Transaction GraphQL ID

A unique 32 character transaction identifier. (formerly Long Transaction ID)

Gross Amount

Until and including the year 2023 payment processor fees and taxes were stored as transaction fields. The gross amount is equal to the transaction amount plus the payment processor fees plus the taxes.

Payment Processor Fee

Until the year 2024 payment processor fees were stored as fields of a transaction. Since 2024 they are stored as separate transactions.

Platform Fee

Platform fees were once stored as transaction fields. They are now separate transactions.

Host Fee

Host fees were once stored as transaction fields. They are now separate transactions.

Transaction Kinds

Each transaction is of a single “kind.” The following are the "kinds" of transactions:

CONTRIBUTION

Records a contribution made through the platform.

PAYMENT_PROCESSOR_FEE

Records a fee charged by a payment processor.

ADDED_FUNDS

Funds that have been added to a collective account by a fiscal host.

HOST_FEE

Records a host fee allocated to the host in relation either a CONTRIBUTION or ADDED_FUNDS

HOST_FEE_SHARE

Records a revenue share passed to the platform in relation to either a CONTRIBUTION or ADDED_FUNDS

HOST_FEE_SHARE_DEBT

Records a debt to the platform due to a HOST_FEE_SHARE that has not been transferred to the platform.

EXPENSE

Records an expense made through the platform.

PLATFORM_TIP

Records a platform tip added by a contributor to their contribution.

PLATFORM_TIP_DEBT

Records a debt to the platform due to a PLATFORM_TIP that has not been transferred to the platform.

PAYMENT_PROCESSOR_COVER

Records payment processor fees that are covered by a fiscal host when a transaction is refunded (the payment processor do not refund the fees related to the original transaction).

PAYMENT_PROCESSOR_DISPUTE_FEE

Records a fee paid by fiscal host when a contribution is disputed through a payment processor (dispute fees are charged regardless of dispute outcome).

BALANCE_TRANSFER

Usually done when emptying balance (Collective to Host, Project or Event to Collective). Or in some cases, moving balance between Fiscal Hosts.

PREPAID_PAYMENT_METHOD

[LEGACY] records a transaction used for implementing gift cards.

UNNAMED

[LEGACY] records transactions that date earlier then 2018 that experience migration challenges to later ledger versions.

PreviousUnderstanding the LedgerNextTransaction Pairs, Groups & Perspectives

Last updated 1 month ago

Was this helpful?