Currencies

Currencies are different kind of points that can or cannot be monetary that your members can earn, together with standard Points or as an alternative to them. By creating different currencies, you can use units of exchange like Dollars, Miles, Hours, Tokens, Liters, etc. instead of or in addition to regular points.

Before Starting

Before continuing, make sure you've installed and set up Fielo. You should also have created and configured your program.

Default Currencies

Fielo comes with a default Currency called Points. If you used our Fielo Is Almost Ready... post-installation setup tool, you will also have another Currency called Cash.

Points are meant as a virtual currency for your members to redeem, while Cash is meant to represent real money that will be paid out to your members.

Creating a New Currency

If you want to use other currencies beyond the standard one, including ones that allow decimal numbers (e.g. 3.52 liters), you can create your own!

Let's see how you can create a new currency called Stars.

From the Programs tab click on to select Currencies. You can also access this page from the Program view page.

On the Currencies page, click New Currency.

Enter the name of your currency in plural form and the number of decimal places you want to show.

You can have a maximum of 3 decimal places. If you don't want any decimal places (i.e. you want only whole numbers), leave the Number of Decimal Places field blank.

If you're creating a currency to be used with Payouts (usually, one that represents real money that will be paid out), remember to check the Generate payout option. It will automatically have only 2 decimal numbers.

When you're ready, click Save.

You now have a new currency in Draft. If you made a mistake in the name or number of decimal numbers, you can still edit your currency to make any changes.

After you review the details, click on Implement Currency. Once it is implemented, it will become active and you can use it as a reward for your incentives or to define the price of the rewards in your catalog.

🚧

You can only edit your currency before implementing it. Once it's implemented, you cannot change its name, the generate payout option or the number of decimal places allowed.

Implementing Your Currency

If your Org has a My Domain already set, you can skip this step. Otherwise, you will need to create a Remote Site to be able to implement your new currency.

In order to set a Remote Site, go to Salesforce Setup, quick find and select Remote Site Settings, and then click on new remote site.

In the Remote Site URL field, add https://[Domain].visualforce.com/services/Soap/m/42.0, replacing [Domain] with the Salesforce domain where the currency is being created. Insert a Remote Site Name you prefer and click on Save.

Or:

If you try to implement the currency before setting the Remote Site, an error message will appear. Copy the URL the system displays in the message, paste it in the Remote Site URL field, insert a Remote Site Name you prefer and click on Save.

Now you will be able to implement your currency! When you're ready to rock and roll, click Implement Currency.

On the currency page, you'll be able to see the new fields that will be created in order to connect your new currency to Fielo objects and in which Programs it is used.

Export Currencies

It is possible to export currencies directly from the Currencies page. That can be really useful if you plan to change environments and need an easy way to create your current currencies in the new environment.

From the Currencies page, click on Export all active to export all active currencies, or select the ones that you want to export before hitting the Export selected button.

When you have the export file, go to the new environment and access the Import page through the program management tools or by searching "Fielo Import" in the App Launcher. Upload the file, validate it, and click on Import.

Note that you can use the import tool to bulk-upload currencies - also deploying them - to your Org.

🚧

To import currencies, use a file that only has currencies' data.

Program Currencies

Program Currencies map all existing currencies to the program where they'll be used. This means that for every currency you want to include in a program, you must relate it to the program. It also lets you specify unique settings for each type.

📘

New Programs

When you create a new program, all currencies that you've already created will be included in the new program automatically.

Creating a Program Currency

To add a new Program Currency, simply choose the program in which you'd like to use your currency. Once there, access the Currencies tab and click on Use for the currency in question.

And in case you wish to not use a currency in your program anymore, simply click on the next to it and select Delete.

👍

You can also create a new currency in your ORG by clicking on the New Currency button in this same page.

After you have related a new currency to your program, you can complete (or edit, in the future) the currency's settings by clicking on the icon at its side and selecting Edit.

• Program: the program you're connecting your currency to. By default, the program you're in is already selected.
• Currency: choose which currency you want to connect to the current program.
• Request Point Approval: When , each new currency record must be approved before giving it to members and an Authorization Workflow must be established. In this case, currencies are generated with the status of Pending and are only made part of a member's balance upon approval. Otherwise, when , all point records are created with a status of Approved.
• Audit Points: When , Fielo will track which currency is used in each redemption. It applies only to redemption transactions' currency consumption - does not apply to expiration transactions.
• Expiration Mode is where you choose if records for this currency will ever expire and, if so, how. There are three expiration options:
  • None: Points generated by a currency will never expire. They'll remain valid as long as the program they belong to exists.
  • Total: All currency records from a member's balance will expire completely by means of a transaction of type Expiration. The expiration date must be prior to the date the expiration takes place and the member must have a positive balance. Total Expiration Mode only works by using the Expire Total Points API or Expire Total Currency API.
  • Partial: Currency records expire independently according to the Rules or Challenge Rewards that generated them. Expiration is carried out by the batch process called Expired Points: Partial Mode, and each record is expired individually. The expiration date must be prior to the date the expiration takes place and the member always maintains a positive balance.

🚧

Regardless of expiration mode, only currency records with status of Approved can be expired. Currencies that generate payouts cannot be expired.

• Actual Cost: If you use or plan to create a budget for your program, it is mandatory to specify an actual cost for currencies that don't generate payout, so that they can be taken into account in the budgeting too.
• Default Expiration Mode & Value: If your program currencies is using the partial expiration mode, you can (optionally) set a default expiration period. This means that, when you award this currency in a new Rule or Challenge Reward, the expiration period that you specify here will be automatically filled in. This is also how the expiration date will be calculated for points refunded from reverted redemptions.
• Opt-Out Expiration Mode & Value: If a member opts out of the program, this (optional) expiration period sets a time limit on how long the member has to redeem any points they may have. This won't apply if the member's points would already have expired in less time than the time period you set here. If you don't set a time period, the expiration date that points already have will still apply. If you set a mode and set the value to 0, member points will be expired immediately upon being opted out.

Once you're happy with the all the settings, click Save.

📘

For Currencies that have Partial Expiration Mode to expire on a regular basis, you need to schedule a batch process manually.

1. From Salesforce Setup, quick find and select Apex Classes.
2. Click on Schedule Apex.
3. Give it the name "Partial Expiration Point Batch" and, for Apex Class, search for and select PointsPartialExpirationBatchSchedule.
4. Under Frequency, choose Weekly and check all days.
5. Give it an end date of as far out into the future as possible and a preferred start time of 12:00 AM.
6. Click Save.