Grassrootz foreign currency donations
When a donor gives in a currency other than your organisation's base currency, Grassrootz sends the original currency and amount but does not include the settled local currency amount from your payment gateway. MoveData uses the Infer Settlement Currency setting to approximate the settled value using the exchange rate provided by Grassrootz.
Why foreign currency donations need special handling#
Grassrootz processes payments through Stripe, which settles funds in your organisation's base currency (typically AUD). However, Grassrootz does not explicitly provide the settled currency amount from your payment gateway. Instead, Grassrootz sends:
- The original currency (for example, USD)
- The original amount (for example, $21.85 USD)
- The exchange rate used by Stripe at the time of the transaction
Without the Infer Settlement Currency setting enabled, MoveData writes the original foreign currency amount to Salesforce. This is not recommended, as it does not reflect the actual value received in your local currency and can produce inaccurate financial reports.
Enable Infer Settlement Currency#
Step 1: Open your integration settings#
- In Salesforce, open the MoveData app.
- Click the Integrations tab.
- Locate and open your Grassrootz integration.
- Click Edit.
Step 2: Enable the setting#
- Click Next to advance to the settings screen.
- Set Infer Settlement Currency to True (this is the default setting).
- Click Save.
How the inference works#
When Infer Settlement Currency is enabled and MoveData receives a foreign currency donation, it:
- Reads the
exchangeRateprovided by Grassrootz in the webhook payload. - Multiplies the original amount by the exchange rate to calculate the approximate settled amount.
- Uses the settled amount (in your base currency) as the donation value in Salesforce.
- Populates additional multi-currency fields on the notification so you can see both the original and inferred values.
Note
Grassrootz does not explicitly provide the settled currency value from your connected payment gateway. The inferred amount is the best approximation available, calculated from the exchange rate Grassrootz supplies. This may differ slightly from the actual settlement amount processed by Stripe. This is a limitation of the data provided by Grassrootz and is not something MoveData can control.
Verify it worked#
After enabling Infer Settlement Currency:
- Check the Notifications tab in the MoveData app for recent Grassrootz donations.
- Open a notification that involves a foreign currency donation.
- Confirm the Salesforce record shows the inferred settled amount in your base currency, not the original foreign currency amount.
Success
To trigger a test notification, open Grassrootz, find a recent donation, click Edit, then click Save. This pushes a notification through from Grassrootz to MoveData.
Troubleshooting#
The inferred amount does not match my bank statement
The exchange rate provided by Grassrootz is the rate at the time of the transaction. The actual settled amount from Stripe may differ due to timing differences between the transaction and settlement, rounding applied by Stripe, or additional gateway fees applied after the exchange. For most reporting purposes, the difference is minor. This is a limitation of the data provided by Grassrootz and is not something MoveData can control.
I enabled Infer Settlement Currency but amounts are unchanged
The Infer Settlement Currency setting only affects donations made in a currency different from your organisation's base currency in Grassrootz. Donations in your base currency are not affected. Check that you are testing with a genuine foreign currency donation.