Skip to content

Latest commit

 

History

History
201 lines (121 loc) · 10.6 KB

expenses.md

File metadata and controls

201 lines (121 loc) · 10.6 KB
Raw

Expenses

Filter

Type

  • All expenses
  • Charge
  • Invoice
  • Receipt
  • Grant
  • Settlement
  • Unclassified

Payout

  • All methods
  • Open Collective
  • Bank Transfer
  • PayPal
  • Virtual Card
  • Other

Period

  • All time
  • Today
  • This Month
  • Past Week
  • Past Month
  • Past Year

Custom Date selection

  • Timezone - Local or UTC - By default, all dates are filtered and displayed using your local timezone. You can switch to UTC to indicate that the dates provided above use the Coordinated Universal Time format, which matches how email reports are generated.
  • Start Date
  • End Date

Amount

  • All
  • $0 - $50
  • $50 - $500
  • $500 - $5,000
  • $5,000 and above

Status

  • Pending: Expense was submitted to the collective. We're waiting for the collective admin to approve this expense.

  • Approved: Expense was approved by a collective admin. We're now waiting for the Fiscal Host admin to pay for it.

  • Rejected: Collective admin rejected the expense. This is a possible final state for the Expense.

  • Processing: Expense was paid by the Fiscal Host. We're waiting for a third-party service (Wise or PayPal) to confirm the transaction was completed.

  • Error: Expense was paid by the Fiscal Host but something went wrong with the transaction. This is a possible final state for the Expense, the Fiscal Host will probably reach out to the User to solve any possible issue.

  • Paid: Expense was sucessfully paid. This is the final state for the expense.

  • SPAM: This Expense was marked as SPAM and will be ignored. This is the final state for the expense

  • Incomplete: Marks the expense as incomplete if there are important details missing to complete the payment. Only Approved/Error expenses can be marked as incomplete.

This action allows a comment to be added to the Expense activity logs and also emails the user requesting their attention.

After the user edits the expense, the expense is moved back to its previous state unless the amount is also changed, which will set the expense as Pending so the collective admin can reevaluate it.

  • Ready to Pay - Reference the Go to Pay section below.

Order

  • Newest First
  • Oldest First

Paying Expenses

Security Checks

{% hint style="info" %} This is the first batch of security checks we have implemented. They were created based on past cases we had on the platform, and we plan to keep iterating on these checks with the input of fiscal hosts. You can contribute with feedback here: https://:.com/opencollective/opencollective/issues/6097 {% endhint %}

We're adding warnings about payees to protect Collectives and Hosts from fraudulent expense claims.

These warnings are designed to inform you as to whether you should approve or pay an expense. They are not a part of an enforcible policy within Open Collective but we encourage hosts and Collectives to consider creating and documenting policies as part of their terms or code of conducts if needed.

You'll find the Security Checks with other expense processing buttons.

You can review the Security Checks by clicking the shield button. This button varies in color following the highest risk level we found in the expense. In the case the expense poses a high-security level, we're also presenting this information as a necessary confirmation before you go to the Pay modal.

The Security Checks modal.

The security checks are categorized in scope and risk level. The categories are:

  • User: The user who submitted the expense, the author of the expense or draft sent as an invite to submit the expense.
  • Payee: If the beneficiary is not the user who originally submitted the expense, we also list checks on that profile through the Payee scope.
  • Payout Method: The actual beneficiary information that is going to be paid by the expense.

The risk levels are:

  • PASS: Opposite of a security risk, actually indicates good record or behavior.
  • INFO/LOW: Contextual information for transparency sake, these are informations that may be important on a particular context but are not meaningful by themselves.
  • MEDIUM: Important to consider, may require some investigation given the context.
  • HIGH: Represents a risk or complete lack of information and requires investigation. This behavior was previously related to fraud.

It is important to understand that these checks are evaluated independently, and it is up to the host admin to evaluate the whole context and take their decision. The security checks currently implemented are listed below, but keep in mind that we'll keep working on adding new check routines and adjusting their existing levels. Some of the existing security checks include:

  • User impersonation checks based on IP correlation and Connected Accounts username overlaps.
  • User 2FA status conveys the security risk of the author account itself.
  • User role in the Collective and/or Fiscal Host exposing how the user relates to the collective or fiscal host.
  • Past user behaviour based on expenses rejected or marked as spam.
  • Past expenses that have been submitted on the platform and in the same collective.
  • Bank account information and PayPal email correlation between users and collectives.

Go to Pay

Green button showing that an expense has been approved and there are sufficient funds. If you click this button, the pay expense modal will be displayed and you'll be able to pay for the expense using a suitable method.

Pay Expense modal displayed for an expense submitted with Bank Account on a Host connected to Wise.

The action button displayed in this modal will vary with the available integration the host have and the payout method selected by the user who submitted the expense.

In the case you're paying with PayPal, if you click the action button the expense will automatically be paid from the connected PayPal account. If you're using PayPal Payouts, the expense will be marked as Scheduled for Payment and automatically processed by the payment worker.

In the case you're paying with Wise, if you click the action button the expense will automatically be paid from your main Wise balance. If your Wise requires OTP authorization, the expense will be Scheduled for Payment and a banner will be displayed on top of your expenses list so you can pay all the scheduled expenses in a batch with a single validation.

Scheduled Wise expenses are paid manually in batch with your account requires OTP authorization.

Mark as Paid

Green button for manual payments. After paying via another method (bank transfer, etc), click this to deduct the amount for the Collective's budget in the system.

Edit

Host admins have permission to edit expenses at any time. For example, someone wasn't able to attach their receipt and emailed it instead, and you are adding it for them.

Note: If you edit an expense, it must be re-approved.

Open Expense

If you click the title of an individual expense, you will go to that expense's page. There, you can see all details and read or add comments.

Connect PayPal & refill balance

PayPal allows you to pre-approve $2,000 at a time to be paid through the API. This is a security feature. This means after you've paid out $2,000 in expenses, you need to refill the balance. If you try to pay an expense and get an error about the PayPal balance, it's time to refill.

When you click "refill balance" you will be prompted to log in to PayPal, and afterwards you'll be taken back to your dashboard.

You can see the connected PayPal account in the top right. This is the account expenses will be paid out of.

If you manage multiple PayPal accounts, make sure it's the right one! If it's not correct, open PayPal in another tab and manually log out, then click "refill balance" and use credentials for the right account.

Payment Error Troubleshooting

Payment errors will show in red next to the expense if they come up.

Common reasons for a payment to fail after clicking the "Pay with PayPal" button:

  • Need to refill the pre-approval balance
    • Click the 'refill balance' button
  • Insufficient funds to cover fees
    • There are not enough funds in the Collective to pay this expense. Many Collectives submit expenses in anticipation of future funding.
    • If a user submits an expense for 100% of the Collective's balance, there won't be enough to cover processing fees
    • Edit the expense total down to leave enough for the fees and inform the user by leaving a comment
  • User's PayPal account is restricted
    • Ask the user to log into PayPal and resolve the issue on their side

Multi-Currency Expenses

Here is an example of how a Multi-Currency expense will show in the expense list. The amount will show in the expense currency, with the amount converted into the host currency below.

The same will show in the pay expenses modal. Example below.