🚨 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
On this page
  • PayPal Payouts
  • How does it work?
  • Fees
  • Limitations and Prerequisites
  • Connecting to PayPal Payouts
  • Reducing Risks
  • Adaptive Payments
  • Disconnect from Paypal

Was this helpful?

Edit on GitHub
Export as PDF
  1. Fiscal Hosts
  2. Payouts

Payouts with PayPal

Instructions on how to safely connect to PayPal.

PreviousVirtual Card SettingsNextPayouts with Wise

Last updated 1 year ago

Was this helpful?

Helpful Links

  • Website
  • Blog
  • Contact
  • Slack

â’¸ Open Collective 2024

With the implementation of the new , we are currently in the process of updating our documentation and some pages may be out of date. Thank you for your patience. Please our support team if you need any assistance.

There are two ways you can process expenses using PayPal: using PayPal Adaptive Payments or PayPal Payouts.

PayPal Payouts

This feature is not supported for independent collectives. If you are an independent collective we recommend using Wise for payouts.

For hosts that are using PayPal, this integration can be used to automate expense payment by providing a one-click solution for paying expenses using .

After connecting your PayPal account, you'll be able to schedule expenses submitted using PayPal as a payout method for mass-payout without needing to reauthorize with PayPal every $2,000 USD. Expenses scheduled for payout also have a higher limit (up to $20,000 per expense) and cheaper fees, you can schedule expenses for payout up to your existing PayPal balance.

How does it work?

The new payment process is asynchronous, meaning that expenses are now scheduled for payout and dealt with by a scheduled worker. This worker runs once every hour, this means that at the turn of the clock we'll bundle the scheduled expenses and pay them in a single request to PayPal.

After being processed by the worker, the expense is marked as in Processing and individually tracked. We'll make sure its status is up-to-date on our platform, bear in mind that in the case the recipient doesn't have a PayPal account, they have up to 30 days to create and accept the payment.

If the payment is successful, the expense is marked as Paid, and in case something goes wrong during this process the expense will be marked as Error so you can try it again or process it manually.

Fees

What are the fees involved?

The fees are charged by PayPal and its value will vary with the currencies being and value being transferred. You can read more about it .

Who pays for the fees?

These fees are paid by the collective the expense was submitted for. This means that transactions in PayPal will display the fees but that value will also be deducted from the collective balance in our platform as a payment processor fee.

Limitations and Prerequisites

  • A PayPal business account with:

    • Access to PayPal Payouts.

    • A confirmed identity, email, and bank account linked to your PayPal business account.

    • Sufficient funds in your PayPal business account.

  • Payments should respect the fund amount you have accounted for in the platform.

    • You can't pay expenses if the budget accounted for the collective is not enough to cover the transfer expenses.

  • The host is still responsible for managing funds in PayPal.

    • Expenses are paid with your PayPal Balance.

Connecting to PayPal Payouts

If you're already in the beta test group, you can follow these instructions:

  1. Create a new PayPal app

    • In My Apps & Credentials page, select the Live environment, and click in Create app.

    • Name this App after Open Collective, this way you'll always remember where this token is being used.

    • App Type: Merchant

    • Click Create App.

2. In App settings, make sure the following boxes are checked:

  • Accept payments (if you wish to enable payments with PayPal)

  • Payouts (if you wish to enable expenses payout with PayPal)

  • Customer Disputes

  • Transaction Search

3. Now, copy the necessary information to Open Collective.

  • Open your Host collective settings page and click on the Sending Money option in the menu.

  • Copy and paste Client ID and Secret in the respective fields.

  • Click Connect PayPal

Done! Next time you pay for an expense submitted with PayPal and you select the automatic method, your expense will be marked as Scheduled for Payment and processed using PayPal Payouts!

Reducing Risks

In order to reduce risks related to having an active API token that is able to create and fund transactions, we strongly suggest you:

  • Keep just enough balance in PayPal to pay your expenses.

    • This can be achieved by calculating the amount needed for the current payment cycle and transferring it beforehand.

Adaptive Payments

PayPal deprecated Adaptive Payments for quite some time already, maintaining this feature has proven to be a challenge and this is why we're also deprecating Adaptive Payments on our side.

Please migrate to PayPal Payouts if you're currently using it as we can no longer guarantee the future operation of this feature.

Adaptive Payments are the easy way and it is automatically enabled for everyone.

From your host dashboard, you can connect your PayPal account and pre-approve up to $2,000 USD in payouts. Make sure that you are connecting the PayPal account connected to the same bank account as your Stripe account.

On the host dashboard, expenses that have been approved and have a sufficient budget will show a "pay" button. With just one click you can pay the expense. After paying out $2,000, you'll need to re-authorize with PayPal (this is a security feature).

For single payments larger than $2,000, make a manual payment

Disconnect from Paypal

  1. Click on the admin button on the top right-hand side of your fiscal host page.

2. Go to your Fiscal host settings

3. Click on Sending money

4. Disable Paypal

There's a manual request that needs to be filled, .

PayPal Payouts is currently in beta test, if you're interested in testing this feature, please .

Open page and Log In.

Open a new tab and go to .

Dashboard interface
contact
PayPal Payouts
here
more information here
contact us
PayPal's Developer
Open Collective
An expense submitted to Open Collective Engineering paid using PayPal.