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
  • Contributions
  • Refunded Contributions
  • Perspectives of Refunded Contributions
  • Disputed Contributions

Was this helpful?

  1. Advanced
  2. Understanding the Ledger

Contributions in the Ledger

Learn more about how Contributions and Refunds are reflected in Open Collective's ledger.

PreviousFiscal Host Ledger PerspectiveNextAdded Funds in the Ledger

Last updated 17 days ago

Was this helpful?

Contributions

  1. A contribution will typically include a pair of CONTRIBUTION transactions and a pair of PAYMENT_PROCESSOR_FEE transactions.

  2. If the contribution is made to a Collective that is hosted by a Fiscal Host and if that host charges a hosting fee then there will also be a pair of HOST_FEE transactions.

  3. If a Fiscal Host has a revenue share agreement with the platform then there will also be a pair of HOST_FEE_SHARE transactions:

    1. If HOST_FEE_SHARE applies and the payment processor supports it, the contribution will be split during processing: the Fiscal Host and the platform will each receive their portions, and the HOST_FEE_SHARE amount will be sent directly to the platform.

    2. If that is not possible, the entire contribution amount (minus the payment processor fee) is directed to the Fiscal Host and a pair of HOST_FEE_SHARE_DEBT transactions are also created to account for money owed by the Fiscal Host to the platform. The debt transactions are later aggregated and used to generate an expense through which the Fiscal Host pays the platform and the debt is reconciled.

As a result, a single contribution can result in a set of transactions:

Refunded Contributions

When contributions are refunded, a new transaction group is created. It contains a set of opposite (relative to the contribution itself) transactions:

  1. The contribution is returned: debited from the Collective and credited to the contributor

  2. The host fees are returned: debited from the Fiscal Host and credited to the Collective.

  3. The host fee share paid to the platform is returned: it is debited from the platform and credited to the Fiscal Host.

  4. The host fee share debt is cancelled: it is debited from the Fiscal Host and credited to the platform.

  5. Payment processor fee transactions are not reversed since they are typically not refunded by the payment processors. In such cases, Fiscal Hosts cover the payment processor fees that have not been refunded, and this is represented in the ledger with a pair of PAYMENT_PROCESSOR_COVER transactions.

As a result, the ledger footprint of a refunded contribution includes:

  1. The contribution transactions are one transaction group.

  2. The refund transactions are a second transaction group.

  3. There is a relationship between the transactions in the two transaction groups. Each transaction in the contribution transaction group (except the payment processor fees) will have a Refund Transaction ID that points to the opposite transaction in the refund transaction group.

  4. The contribution transactions will be marked as REFUNDED.

  5. The related refund transactions will be marked as REFUND.

It is possible to imagine these two transaction sets existing side by side:

Perspectives of Refunded Contributions

From a contributor's perspective, a refunded contribution looks like a straightforward pair of opposite transactions: a debit when the contribution was made and a credit when it was refunded.

From a Collective's perspective, a refunded contribution looks slightly less symmetric because the PAYMENT PROCESSOR FEE transaction is not refunded and is instead reflected by the PAYMENT PROCESS COVER transaction:

From a Fiscal Host “Operational Funds” perspective, a refunded contribution looks symmetrical except for the PAYMENT PROCESSOR COVER transaction:

From a Fiscal Host “Managed Funds” perspective, a refunded contribution looks the same as it does from a collective perspective:

Disputed Contributions

A dispute occurs when a contributor files a complaint with a payment processor (usually because of suspected fraud). If a dispute is settled in favor of the Fiscal Host the contribution transactions in the ledger remain unchanged. If a dispute is settled in favor of a contributor the transaction will be refunded (and refund transactions will be created in the ledger).

Regardless of the dispute outcome, payment processors charge a dispute fee (paid by the Fiscal Host) which is recorded in the platform as an additional pair of PAYMENT_PROCESSOR_DISPUTE_FEE transactions:

Find out more about .

Platform settlement expenses
A table showing an example of a contribution that has a Host Fee Share.  The first two transactions show the initial contribution as a CREDIT to the Collective and as a DEBIT from the Contributor. The next two transactions show the Payment Processor Fee as a CREDIT to Stripe and as a DEBIT from the Collective. The next two transactions show the Host Fee as a CREDIT to the Fiscal Host and as a DEBIT from the Collective. The next two transactions show the Host Fee Share as a CREDIT to the platform and as a DEBIT from the Fiscal Host. Lastly, the final two transactions show Host Fee Share Debt as a CREDIT to the Fiscal Host and as a DEBIT from the platform.
A table showing an example of a refunded contribution. The table is nearly identical to the one above, with a few exceptions. The first two transactions in the table are for the contribution with a DEBIT from the Collective and a CREDIT to the original contributor. The next two transactions are for the Host Fee, with a DEBIT from the Fiscal Host and a CREDIT to the Collective. The next two transactions are for the Host Fee Share with a DEBIT from the platform and a CREDIT to the Fiscal Host. The next two transactions are for the Host Fee Share Debt, with a DEBIT from the Fiscal Host and a CREDIT to the platform. The final two transactions are to cover the Payment Processor fees that were not refunded with a DEBIT from the Fiscal Host and a CREDIT to the Collective.
A table showing an example of a contribution that has been refunded, featuring all of the transactions that make up the original transaction group as well as the transaction group comprised of all of the transactions that were apart of the refund process. All of the transactions have IDs and all of the transactions (except for the payment processor fees) in the original contribution's transaction group have Refund Transaction IDs that show which refund transactions are associated with each original transaction.
Two tables side by side that provide an example of a refunded transaction. The two tables are identical to the table above, except the two transaction groups appear next to each other with arrows pointing from the original transaction to the corresponding transaction in the refunded transaction group.
A table showcasing an example of a refunded contribution from the contributor's perspective. The first transaction has the type "DEBIT," a property that states "REFUNDED," and an amount of "-$10.00." The second transaction has a type "CREDIT," a property that says "REFUND," and an amount "$10.00."
A table showing an example of a refunded contribution from a Collective's perspective. The first three transactions are associated with the initial contribution and feature a transaction labelled "Contribution," another labeled "Payment Processor Fee," and a final one labeled "Host Fee." The Contribution and Host Fee transactions have a property labeled "REFUNDED," while Payment Processor Fee does not. The last three transactions roughly correspond to the original three transactions, but in reverse: Contribution, Host Fee, and Payment Processor Cover. All three have the label "REFUND."
A table showing an example of a refunded transaction from a Fiscal Host's Operational Funds perspective. The first three transactions are Host Fee, Host Share, and Host Fee Share Debt and all have the label "REFUNDED." The next three transactions are the reverse transactions: they have the same "Kind," but the types have been reversed from CREDIT to DEBIT (and vis versa), and all three have the label "REFUND." The last transaction has the "Kind" Payment Processor Cover and a label of "REFUND."
A table showing an example of a refunded contribution from the perspective of a Fiscal Host's Managed Funds. It is identical to the table showing a Collective's perspective on a refunded transaction.
A table showing an example of transactions associated with a disputed contribution. Both transactions have the Kind "Payment Processor Dispute Fee." The first has the Type "CREDIT," the Account "Stripe," and the amount "$12.00." The second transaction has the Type "DEBIT," the Account "Fiscal Host C," and the Amount "-$12.00."