Table of Contents


Multi-Currency Support

The Partner Program Tiers module provides comprehensive multi-currency support that enables organizations to manage global partner programs with partners operating in different currencies. This functionality ensures fair evaluation of partner performance regardless of the currencies used in their business transactions, while maintaining consistent program currency standards and accurate progress calculation.

Multi-currency support automatically converts opportunity values to program currency during progress calculation, ensuring that revenue-based criteria evaluate partners equitably across international operations and diverse currency environments.

Understanding Multi-Currency in Partner Program Tiers

Multi-Currency Framework

Program Currency: Each partner program operates with a designated base currency that establishes the evaluation standard for all revenue-based criteria within that program. Program currency is selected during program creation and defines how financial thresholds are set and communicated.

Automatic Currency Conversion: When partners create opportunities in currencies different from the program currency, the system automatically converts opportunity values to program currency during progress calculation using configured exchange rates.

Fair Evaluation: Currency conversion ensures partners operating in different currencies are evaluated fairly against the same financial thresholds, preventing currency exchange rate fluctuations from artificially advantaging or disadvantaging partners.

How Multi-Currency Works in Partner Programs

Program Configuration:

  • Administrator selects program currency during program creation (e.g., USD, EUR, GBP)
  • All revenue-based criteria thresholds are defined in program currency
  • Benefit values for Revenue-type benefits are expressed in program currency

Partner Activities:

  • Partners create opportunities in their local or transaction currencies
  • Opportunity currency may differ from program currency (e.g., opportunity in EUR, program in USD)
  • Opportunities maintain their original currency designation

Progress Calculation:

  • System queries partner opportunities using Primary Partner User access permissions
  • System identifies opportunity currency and amount from Rollup Field
  • System converts opportunity amount to program currency using exchange rates
  • System sums converted amounts to calculate total revenue in program currency
  • System compares converted total against program criteria thresholds

Partner View:

  • Partners see their progress calculated in program currency
  • Revenue values displayed in program currency
  • Tier thresholds shown in program currency
  • Ensures consistent understanding of qualification requirements

Program Currency Configuration

Selecting Program Currency

Program currency is configured when creating or editing partner programs.

Currency Selection Location:

  1. Navigate to Setup > Partner Management > Partner Program Tiers
  2. Click Programs tab
  3. Click New Program (or select existing program and click Edit)
  4. In the Currency field, select the base currency for the program
  5. Click Save

Available Currencies:

  • Currency dropdown displays all active currencies configured in your Magentrix instance
  • Only currencies enabled in Company Preferences > Currency Exchange Settings are available
  • Contact Magentrix support if needed currency is not available

Currency Selection Considerations

Business Strategy Alignment:

  • Select currency that aligns with your organization's primary business currency
  • Consider currency used for internal reporting and financial analysis
  • Choose currency that partners understand and relate to most easily

Regional Program Considerations:

  • For regional programs (e.g., European Partner Program), select regional currency (EUR)
  • For global programs, select organization's corporate currency (typically USD)
  • For country-specific programs, consider local currency

Reporting and Analytics:

  • Program currency affects how revenue data appears in reports
  • Consistent currency across programs simplifies comparative analysis
  • Currency selection impacts benefit communication and partner understanding

Example Currency Selection:

  • Global Reseller Program: USD (corporate currency)
  • EMEA Partner Program: EUR (regional currency)
  • UK Channel Program: GBP (local currency)
  • Asia-Pacific Program: USD (corporate currency for consistency)

Currency Conversion in Progress Calculation

Automatic Conversion Process

When calculating partner progress against Total Revenue criteria, the system performs automatic currency conversion:

Step 1: Query Opportunities

  • System queries all opportunities associated with partner account
  • Uses Primary Partner User's data access permissions
  • Applies configured criterion filters
  • Checks Attainment Date Field falls within enrollment period

Step 2: Identify Currency and Amount

  • System reads opportunity currency from each opportunity record
  • System reads revenue amount from configured Rollup Field
  • Maintains original currency designation for each opportunity

Step 3: Convert to Program Currency

  • For opportunities in program currency: Use amount directly (no conversion needed)
  • For opportunities in different currencies: Convert amount using exchange rate
  • Conversion formula: Opportunity Amount × Exchange Rate = Program Currency Amount

Step 4: Sum Converted Amounts

  • System sums all converted amounts to calculate total revenue
  • Total expressed in program currency
  • Total compared against tier thresholds defined in program currency

Step 5: Display Progress

  • Partner progress shows revenue in program currency
  • Criterion current value displays in program currency
  • Partner sees consistent currency across all tier thresholds

Currency Conversion Example

Program Configuration:

  • Program Currency: USD
  • Total Revenue Criterion with thresholds: Launch $25,000, Build $100,000, Scale $500,000

Partner Opportunities:

  • Opportunity 1: $50,000 USD (Closed Won)
  • Opportunity 2: €40,000 EUR (Closed Won)
  • Opportunity 3: £30,000 GBP (Closed Won)

Exchange Rates (configured in Company Preferences):

  • 1 USD = 1 USD (no conversion)
  • 1 EUR = 1.10 USD
  • 1 GBP = 1.27 USD

Conversion Calculation:

  • Opportunity 1: $50,000 USD × 1 = $50,000 USD
  • Opportunity 2: €40,000 EUR × 1.10 = $44,000 USD
  • Opportunity 3: £30,000 GBP × 1.27 = $38,100 USD
  • Total Revenue: $132,100 USD

Tier Qualification:

  • Launch tier ($25,000): Achieved
  • Build tier ($100,000): Achieved
  • Scale tier ($500,000): Not achieved (26% progress)

Partner View:

  • Current Revenue: $132,100 (displayed in USD program currency)
  • Next Tier (Scale) Requirement: $500,000 (displayed in USD program currency)

Exchange Rate Management

System Exchange Rates

Partner Program Tiers relies on exchange rates configured at the system level in Company Preferences.

Exchange Rate Configuration Location:

  1. Navigate to Setup > Manage > Company Preferences
  2. Click Edit
  3. Select Company Information tab
  4. In Locale Settings section, click Manage Exchange Rates & Organization Currency
  5. Configure exchange rates for all active currencies

Exchange Rate Updates:

  • Administrators manually update exchange rates based on current market conditions
  • Optional integration with OpenExchangeRates.org for automatic updates
  • Exchange rate changes affect all subsequent progress calculations

Exchange Rate Impact on Partner Programs

Recalculation Trigger:

  • Updating exchange rates does not automatically trigger partner program recalculation
  • Next scheduled recalculation (5-minute delay after triggering events) will use new rates
  • Administrators can manually recalculate specific enrollments to apply new rates immediately

Historical Calculations:

  • Previous calculations remain unchanged when exchange rates are updated
  • Only future calculations use new exchange rates
  • Historical progress data remains as calculated at that time

Best Practice:

  • Update exchange rates regularly (monthly or quarterly) to reflect current market conditions
  • Communicate exchange rate update schedule to partners
  • Consider exchange rate volatility when setting tier thresholds

Changing Program Currency

Currency Change Impact

Changing a program's currency after partner enrollments exist triggers significant changes.

When Currency is Changed:

  1. Administrator edits program and selects new currency
  2. Administrator saves program configuration
  3. System schedules recalculation (within 5 minutes) for ALL enrolled partners
  4. All revenue-based criteria are re-evaluated using new currency standard
  5. Partner progress updates to reflect new currency calculations

Implications of Currency Change:

Threshold Reinterpretation:

  • Existing threshold values are reinterpreted as the new currency
  • Example: Build tier threshold of "100000" changes from $100,000 USD to €100,000 EUR
  • This dramatically changes qualification requirements if not adjusted

Partner Progress Recalculation:

  • All partner opportunities are converted to new program currency
  • Partner progress may increase or decrease significantly
  • Tier qualification status may change for multiple partners

Benefit Value Reinterpretation:

  • Revenue-type benefits reinterpreted in new currency
  • Example: MDF Allocation of "5000" changes from $5,000 to €5,000
  • Benefit value changes without explicit benefit modification

Currency Change Procedure

If you must change program currency:

1. Planning Phase:

  • Document rationale for currency change
  • Calculate impact on all tier thresholds using current exchange rates
  • Prepare adjusted threshold values in new currency
  • Identify all affected partners and anticipated tier changes
  • Plan partner communication strategy

2. Threshold Adjustment:

  • Before changing currency, calculate equivalent thresholds
  • Example: If changing from USD to EUR with 1 EUR = 1.10 USD:
    • Old Launch threshold: $25,000 → New Launch threshold: €22,727
    • Old Build threshold: $100,000 → New Build threshold: €90,909

3. Program Currency Change:

  • Navigate to Program Details
  • Click Actions > Edit
  • Select new Currency
  • Click Save

4. Threshold Update:

  • Immediately update all criterion thresholds to reflect equivalent values in new currency
  • Edit each criterion to adjust threshold values
  • Click Save (triggers additional recalculation)

5. Benefit Value Update:

  • Update all Revenue-type benefits to reflect equivalent values in new currency
  • Adjust benefit values for all tiers
  • Click Save

6. Partner Communication:

  • Notify all enrolled partners about currency change
  • Explain reason for change and timing
  • Communicate any impact on their qualification status
  • Provide updated tier requirements in new currency

Currency Change Best Practices

Avoid Currency Changes:

  • Plan currency selection carefully during program creation
  • Consider long-term strategy before selecting currency
  • Currency changes create complexity and partner confusion

If Currency Change is Necessary:

  • Schedule during low-activity periods (fiscal year transitions)
  • Coordinate with partner business reviews or contract renewals
  • Maintain equivalent qualification standards to prevent unfair impact
  • Document decision thoroughly for audit purposes

Alternative Approach:

  • Instead of changing currency, consider creating a new program in desired currency
  • Migrate partners to new program over time through enrollment management
  • Maintain both programs during transition period
  • Provides cleaner transition without recalculation complexity

Multi-Currency Best Practices

Program Design for Multi-Currency Environments

Single Currency per Program:

  • Each program operates in one currency only
  • Select program currency based on primary user base or business strategy
  • Maintain currency consistency throughout program lifecycle

Regional Program Strategy:

  • Consider creating separate programs for different regions with appropriate local currencies
  • Example: EMEA Program (EUR), Americas Program (USD), APAC Program (USD or local)
  • Enables culturally appropriate thresholds and local currency communication

Clear Currency Communication:

  • Always communicate program currency to partners during enrollment
  • Display currency symbol prominently in tier requirements
  • Include currency in all program documentation and communications

Exchange Rate Management

Regular Updates:

  • Establish schedule for exchange rate reviews and updates
  • Monthly or quarterly updates recommended for stable currencies
  • More frequent updates for volatile currencies
  • Document exchange rate sources and update rationale

Automatic Integration:

  • Consider OpenExchangeRates.org integration for hands-off management
  • Reduces administrative burden
  • Ensures current market rates
  • Contact Magentrix support to configure integration

Communication:

  • Inform partners about exchange rate update schedule
  • Explain that calculations use system exchange rates
  • Provide transparency about conversion methodology

Threshold Setting in Multi-Currency Context

Exchange Rate Consideration:

  • When setting tier thresholds, consider exchange rate volatility
  • Round thresholds to recognizable, psychologically significant numbers
  • Consider whether thresholds remain appropriate across currency conversions

Example:

  • USD Program with $100,000 Build threshold
  • Equivalent in EUR at 1 EUR = 1.10 USD: €90,909
  • Consider rounding to €90,000 or €100,000 for simplicity if creating EUR program

Competitive Analysis:

  • Research competitive programs in target markets
  • Ensure thresholds are appropriately challenging regardless of currency
  • Adjust for regional economic conditions and market maturity

Partner Communication

Enrollment Communication:

  • Clearly state program currency during enrollment
  • Explain that opportunities in any currency will be converted
  • Provide transparency about conversion methodology

Progress Communication:

  • Always reference amounts in program currency
  • Include currency symbol in all financial communications
  • Avoid confusing partners by referencing amounts in multiple currencies

Tier Advancement Communication:

  • Reference qualification amounts in program currency
  • Congratulate partners on achieving specific currency amounts
  • Clarify benefit values in program currency

Multi-Currency Prerequisites

System Multi-Currency Configuration

Partner Program Tiers multi-currency functionality depends on system-level multi-currency configuration.

Prerequisites:

  • Multi-currency must be enabled by Magentrix support (one-time permanent configuration)
  • Multiple active currencies must be configured in Company Preferences
  • Exchange rates must be configured for all currencies used by partners
  • Base organizational currency must be designated

Verification:

  1. Navigate to Setup > Manage > Company Preferences
  2. Click Edit
  3. Select Company Information tab
  4. In Locale Settings, verify:
    • Multi-Currency Enabled checkbox is checked
    • Manage Exchange Rates & Organization Currency link is visible
    • Multiple currencies are configured with active exchange rates

If Multi-Currency is Not Enabled:

  • Contact Magentrix support to request multi-currency enablement
  • Note: This is a permanent configuration that cannot be reversed
  • Provide list of currencies needed for partner programs
  • Allow time for Magentrix support to complete configuration

Troubleshooting Multi-Currency Issues

Partner Revenue Lower Than Expected:

  • Verify exchange rates are configured correctly for opportunity currencies
  • Check that opportunities are in expected currencies
  • Confirm exchange rate values reflect appropriate conversion ratios
  • Review exchange rate update timing vs. opportunity close dates

Currency Not Available in Program Configuration:

  • Verify currency is configured as Active in Company Preferences > Currency Exchange
  • Contact Magentrix support if needed currency is not available
  • Check that multi-currency is enabled at system level

Progress Not Reflecting Currency Conversion:

  • Verify opportunities have currency values populated
  • Check that Rollup Field contains currency amounts
  • Confirm opportunities meet criterion filter requirements
  • Trigger manual recalculation to apply current exchange rates

Exchange Rate Changes Not Reflecting:

  • Remember that exchange rate changes don't automatically recalculate enrollments
  • Trigger manual recalculation for specific partners to apply new rates
  • Wait for next automatic recalculation trigger (program edit, enrollment date change, etc.)

Currency Conversion Appears Incorrect:

  • Verify exchange rate direction is correct (e.g., 1 EUR = 1.10 USD, not 1 USD = 1.10 EUR)
  • Check that base currency is configured correctly
  • Review exchange rate configuration in Company Preferences
  • Test calculation manually to verify system conversion logic

Jump to Partner Program Tiers Checklist

<< Partner Programs Tab Configuration | Best Practices and Recommendations >>