The Payments and Currencies settings section allows administrators to configure supported currencies and define rules for multiple payment gateways. These settings enable flexible donation handling based on donor location and currency preferences.
1. Currencies #
This setting allows you to define which currencies are available across the platform, including donation forms, campaigns, and events.
- Type: Multi-select dropdown
- Purpose: Establish global currency support
- UI Feature: Each selected currency is displayed with its flag and full name
- Usage: Selected currencies are used as defaults unless overridden per campaign or module
Supported Examples #
- Australian Dollar (AUD)
- Canadian Dollar (CAD)
- Euro (EUR)
- Israeli New Shekel (ILS)
- Pound Sterling (GBP)
- Swiss Franc (CHF)
- United States Dollar (USD)
Currencies can be added or removed via a searchable dropdown interface.
2. Disable CAD Receipts #
This setting disables the generation of tax receipts for donations processed in CAD.
- Type: Number Field
- Function: Enter a threshold amount. If a donation is equal to or less than this value, no receipt will be generated or emailed to the donor.
Example: If set to
20, donations of CAD $20 or less will not generate receipts.
Use this to comply with regional tax receipt regulations or reduce administrative overhead for small donations.
3. Payment Gateways #
You can configure up to 8 separate payment gateways, each mapped to specific currencies and countries. This allows dynamic payment routing based on donor location or selected currency.
Each Gateway Slot includes the following configuration fields:
| Field | Description |
|---|
| Field | Description |
|---|---|
| Names | Dropdown to choose a supported gateway (e.g., Authorize.Net, Stripe, SUMIT) |
| Default Currency | Currency tied to this gateway (e.g., USD, CAD, GBP) |
| Countries Include | Define countries where this gateway is available |
| Countries Exclude | Define countries where this gateway is not available |
| Order | Numerical field to set priority or load order of this gateway |
| Account ID | Gateway account ID used for authentication/connection |
Each gateway configuration controls how donors interact with payment forms, ensuring the right processor is used for the right region.
Add New Gateway #
At the bottom of the Payment Gateways section, you’ll find an Add New Gateway button.
- Use this to define additional gateways.
- Each new slot can be mapped to a new combination of currency, country rules, and gateway provider.
- This allows tailored support for local and international payment needs.
5. Geolocation Rules (Placeholder) #
This section appears in the admin UI, but currently lacks configuration fields.
- Purpose (Expected): Route currency and payment gateway behavior based on the donor’s geolocation
- Status: Placeholder – likely intended for future development or advanced configuration
Tip: Ensure any country-specific routing aligns with the legal and operational rules of your payment gateway providers.
Summary of Gateway Examples #
| Gateway Name | Currency | Provider | Countries |
|---|---|---|---|
| Gateway 1 | USD | Authorize.Net | Custom |
| Gateway 2 | CAD | Authorize.Net | Custom |
| Gateway 3 | GBP | Stripe | Custom |
| Gateway 4 | EUR | Stripe | Custom |
| Gateway 5 | ILS | SUMIT | Custom |
| Gateway 6 | Default | Authorize.Net | Custom |
| Gateway 7 | AUD | Stripe | Custom |
| Gateway 8 | CHF | Stripe | Global (All) |
Use this setup to provide seamless payment experiences tailored to your international audience.
