Grassrootz fee information
Grassrootz captures detailed fee breakdowns for each donation. MoveData surfaces these fees as variables in the Donation phase of the processing pipeline, making them available for mapping to Salesforce fields through your extension flows.
Overview#
When a donor makes a donation through Grassrootz, several fees may be deducted before the funds reach your organisation. Understanding these fees is important for accurate financial reporting and reconciliation in Salesforce.
Grassrootz fee breakdowns fall into two categories:
- Summary fee variables — high-level totals that combine multiple fee types
- Detailed breakdown fields — granular per-fee-type amounts, percentages, and taxes available as custom fields
Summary fee variables#
These variables are available in the Donation phase of the MoveData pipeline. They provide a consolidated view of fees applied to each donation.
| Variable | Example | Description |
|---|---|---|
Fee |
6.89 |
Sum of all fees (gateway + platform) |
FeeGateway |
0.84 |
Fee charged by the payment gateway (for example, Stripe) |
FeePlatform |
6.05 |
Sum of all platform-level fees |
FeePlatformPublic |
3.85 |
Platform fee covered by the donor in the transaction |
FeePlatformPrivate |
2.20 |
Platform fee charged by Grassrootz to the organisation (typically for mass participation events) |
Note
The Fee variable is the total of FeeGateway + FeePlatform. The FeePlatform variable is the total of FeePlatformPublic + FeePlatformPrivate.
How fees relate to each other#
Fee (total)
├── FeeGateway (payment gateway fee, e.g. Stripe)
└── FeePlatform (all platform fees)
├── FeePlatformPublic (donor-covered platform fee)
└── FeePlatformPrivate (organisation-charged platform fee)
Detailed fee breakdown fields#
In addition to the summary variables, MoveData captures granular fee information from Grassrootz as custom fields on the donation notification. These fields provide a full picture of every fee component, including taxes and percentages.
| Field | Description | Example |
|---|---|---|
donationPaymentPlatformFee |
Payment platform processing fee | 0.96 |
donationPaymentPlatformFeeTax |
Tax on the payment platform fee | 0.09 |
donationEventOrganizerFee |
Fee set by the event organiser | 0.88 |
donationEventOrganizerFeeTax |
Tax on the event organiser fee | 0.08 |
donationEventOrganizerFeePercentage |
Event organiser fee as a decimal percentage | 0.044 |
donationSilentFee |
Silent fee amount | 0 |
donationSilentFeeTax |
Tax on the silent fee | 0 |
donationSilentFeePercentage |
Silent fee as a decimal percentage | 0 |
donationFee |
Platform donation fee | 3.55 |
donationFeeTax |
Tax on the platform donation fee | 0.32 |
donationFeePercentage |
Platform donation fee as a decimal percentage | 0.05 |
donationNet |
Net amount after all fees and taxes are deducted | 49.16 |
Understanding each fee type#
Gateway fee (FeeGateway)#
The gateway fee is charged by the payment processor (typically Stripe) for processing the transaction. This covers card processing, fraud protection, and payment infrastructure costs. MoveData surfaces this as both the summary FeeGateway variable and the detailed donationPaymentPlatformFee field.
Platform fee (FeePlatform)#
Platform fees are charged by Grassrootz for use of the fundraising platform. These can be split between the donor and the organisation:
- Public fee (
FeePlatformPublic): The portion of the platform fee that the donor opted to cover at the time of donation. This is visible to the donor during checkout. - Private fee (
FeePlatformPrivate): The portion of the platform fee charged to your organisation by Grassrootz. This is common for mass participation events and is not visible to the donor.
Organiser fee (donationEventOrganizerFee)#
The organiser fee is set by the event organiser within Grassrootz. This is a percentage-based fee applied to each donation. The percentage is available in the donationEventOrganizerFeePercentage field.
Silent fee (donationSilentFee)#
Silent fees are additional fees that may be applied to a transaction. These are configured within Grassrootz and are not visible to the donor. In many integrations, silent fees are zero.
Net amount (donationNet)#
The net amount is the final value received by your organisation after all fees and taxes have been deducted. This is the amount that typically matches your settlement from Stripe.
Mapping fees to Salesforce fields#
The summary fee variables (Fee, FeeGateway, FeePlatform, FeePlatformPublic, FeePlatformPrivate) are available in the Donation phase of the MoveData pipeline. You can map these to Salesforce fields using your extension flows.
The detailed breakdown fields (for example, donationPaymentPlatformFee, donationNet) are available as custom variables on the MoveData notification. To use these in Salesforce:
- Create custom fields on the Opportunity (NPSP) or Gift Transaction (Nonprofit Cloud) object to store the fee values you need.
- Add Assignment elements in your MoveData Donation flow to map the fee variables to your custom fields.
Example: Calculating gross vs net for reporting
If a donation of AUD 55.00 is received with the following fees:
| Component | Amount |
|---|---|
| Gross donation | $55.00 |
Gateway fee (FeeGateway) |
$0.84 |
Platform fee — public (FeePlatformPublic) |
$3.85 |
Platform fee — private (FeePlatformPrivate) |
$2.20 |
Total fees (Fee) |
$6.89 |
Net amount (donationNet) |
$49.16 |
Note that $55.00 - $6.89 = $48.11, not $49.16 — the difference arises because FeePlatformPublic ($3.85) was added on top of the base donation by the donor, meaning the donor paid $55.00 but the base amount before the public fee was $51.15. The donationNet value reflects the actual settlement amount.