🚨 This documentation is out of date.
View our New Documentation!
Open Collective Docs
Go back to Open Collective
  • Welcome
  • About
    • Introduction
    • Documentation
    • Terminology
    • Company
    • Pricing
    • Team
    • The Open Collective Way
      • Mission and Values
      • Community Guidelines
    • Hiring
    • Investors
    • Contributing
    • Refund Policy
    • Contact Us
  • Product
    • Features
    • Roadmap
    • Comparison
    • User Profile
    • Dashboard
      • Preview Features
    • Currencies
    • Log-in System
    • Privacy Policy
    • Moderation
    • Security
    • 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
    • Notifications
    • Two-factor Authentication
    • Activity Log
  • Collectives
    • Collectives FAQ
    • Creating a Collective
    • Quick Start Guide
    • Collective Settings
      • Customize Collective
      • Team
      • Collective Goals & Tiers
      • Expense Policy
      • Data Export
      • Security
      • Integrations
      • Zero Collective Balance
      • Closing a Collective
    • Add Fiscal Host
    • Change Fiscal Host
    • Open Source Collectives
      • Setting up GitHub Sponsors
    • Transparent Budget
    • Expenses
    • Updates & Comms
    • Custom Email
    • Moderation
    • Conversations
    • Events
    • Projects
    • Funding Options
    • Buttons & Banners
    • Connected Collectives
    • Contribution flow
  • Financial Contributors
    • Financial Contributors FAQ
    • Guest contributions
    • Payments
    • Platform Tips
    • Website Badge
    • Receipts
    • Collective to Collective
    • Organizations
      • Organization FAQ
      • Funds
      • Bulk Transfers
      • Gift Cards
      • Sustainer Resources
  • Expenses & Getting Paid
    • Expenses FAQ
    • Submitting Expenses
      • Inviting a third-party to submit an Expense
    • Expense Comments
    • Edit or Download an Expense
    • Receiving payment through Payoneer or Wise
    • Tax Information
  • Fiscal Hosts
    • Fiscal Hosts FAQ
    • Becoming a Fiscal Host
    • Creating a Fiscal Host
    • Organisation Settings
      • Info
      • Customize Profile Page
      • Connect external accounts
      • Accounting Categories
      • Security
      • Manage updates
      • Policies
    • Fiscal Host Dashboard
      • Expenses
      • Financial contributions
      • Pending applications
      • Hosted Collectives
      • Vendors
      • Transaction Report
        • Reports
    • Receiving Money
      • Bank Transfers
      • Credit Card
      • Add Funds Manually
      • Expected Funds
    • Payouts
      • Virtual Card Settings
      • Payouts with PayPal
      • Payouts with Wise
      • Two-factor authentication for payouts
      • Refunds
    • Host Fees
    • Local Tax Support
    • Agreement Templates
  • Independent Collectives
    • About Independent Collectives
    • Create an Independent Collective
      • Migrate from Self-Hosted to Independent Collective
      • Migrate from a Fiscal Host to Independent Collective
    • Independent Collective Setup
    • Independent Collective Management
      • Money coming in: Contributions
      • Money going out: Expenses
    • Close an Independent Collective
  • Contributing
    • Design
      • Design Workflow
      • Design Contribution Guidelines
    • Development
      • Contribution Guide
      • Best Practice Guidelines
      • Bounties
      • Architecture
      • API
        • Members
        • Collectives
        • Events
      • README Integration
      • PayPal
      • TransferWise
      • Post-Donation Redirect
      • Manual Reporting
      • GitHub Permissions
      • Internationalization (i18n) system
      • Testing with Cypress
      • Testing features
        • Conversations
      • Collective's locations
      • Virtual Cards
    • Documentation
      • Resources for documentarians
      • Style guide
      • Suggesting changes
    • Translation
  • Developers
    • OAuth
    • Personal Tokens
Powered by GitBook

Helpful Links

  • Website
  • Blog
  • Contact
  • Slack

â’¸ Open Collective 2024

On this page
  • Transaction Fields
  • Transaction Kinds

Was this helpful?

Edit on GitHub
Export as PDF
  1. Product
  2. Ledger

Individual Transactions

Transaction Fields

Name
Description

Date & Time

Date/time transaction was created

Effective Date

A date manually entered by an admin in order to record a retroactive off-platform transaction. If no manual date was entered the effective date is the same as the transaction date (from the Date & Time field).

Transaction ID

Unique transaction identifier

Group ID

Transactions that are created together have the same group identifier.

Description

A descriptor that is automatically generated when a transactions is created based on the context in which the transaction was created.

Credit / Debit

Indicates if the transaction is a credit or a debit.

Contribution ID

If the transaction is related to a contribution, this references the contribution (which references the contributor).

Expense ID

if this transaction is related to an expense this references the expense (which references the expense submitter, the collective admin that approved and the fiscal host admin that paid it).

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.

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

Name
Description

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:

Transaction Kind
Description

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.

PreviousLedgerNextTransaction Pairs, Groups & Perspectives

Last updated 12 months ago

Was this helpful?