Charity Donations
This Feature Reference provides detailed information on how to configure and use the Charity Donation feature.
Revision History
07/07/2025
Initial Documentation Release.
08/06/2025
Updated with review comments.
07/04/2026
Charity: Prompt Only Outside
Overview
Feature Description
The charity donation feature enables a customer to donate certain amount to a charity. Only one charity can be active for any site. The system prompts customers during tendering process for charity donation. Customers are asked if they wish to make a charity donation.
Requirements
Supported Hardware Configurations
Verifone Commander with Topaz, Ruby2, and C18
Software Requirements
Verifone Commander Release 53.40 and above
PIN pads
P400
M400
MX 915
Configuring Charity
Department Configuration
From Configuration Client > Store Operations > Merchandise > Departments, create a department for charity with NACS product code 971. Department name is what is shown to customer.
Cash MOP Configuration
From Configuration Client > Store Operations > Payments > MOP enable “Tender Amount Required” for Cash MOP. Refer to the Method of Payment topic in the Commander User Reference for more information on creating MOPs. The document is available on Verifone Cloud and Verifone Premier Portal.
Refer to the Method of Payment topic in the Commander User Reference for more information on creating MOPs. The document is available on Verifone Cloud and Verifone Premier Portal.
Charity Donation Configuration
Use Store Operations > Charity Donations in Configuration Client and Store Operations > Charity Donations in Verifone Central to configure Charity Configuration.
If the charity department does not have NACS product code 971 assigned, it will not appear in the Department drop-down in this form.
When the customer is using Cash as MOP, there are two options that can be enabled from configuration client to be presented to the customers on the PIN pad:
Donate change amount (rest for charity) and is calculated as the difference between the amount due and the amount paid.
Round to next dollar amount which rounds off their transaction to the next whole dollar. The donation amount is the difference between the total amount of the purchase and the rounded dollar amount.
When the customer is using Cash as MOP, extra amount should be entered in the Cash - Enter Amount input overlay to get the charity prompt.
Enable Charity Donations
Enables the Charity Donations program.
Note: When Enable Charity Donations is selected, by default Prompt Indoor is selected and cannot be edited.
Department
Select the charity department.
If the charity department does not have NACS product code 971 assigned, it will not appear in the Department drop-down in this form.
Cash
Cash is only available for indoor charity.
Cash
Rest for charity - Select if this option appears for cash payments. This donates the remaining amount for charity.
Cash
Round to next dollar - Select if this option appears for cash payments. Rounds off the transaction to the next whole dollar. The donation amount is the difference between the total amount of the purchase and the rounded dollar amount.
Card
Cards can be used for both Indoor and Outdoor charity.
Card
Preset Amount 1 - Enter the preset amount option 1.
Card
Preset Amount 2 - Enter the preset amount option 2. This option is only available for outside transactions.
Card
Preset Amount 3 - Either “Preset Amount 3” or “Round to next dollar” can be selected as the third option. Enter the preset amount option 3.
Card
Round to next dollar - Either “Round to next dollar” or “Preset Amount 3” can be selected as the third option. Select if this option appears for credit/debit card payments. Rounds off the transaction to the next whole dollar. The donation amount is the difference between the total amount of the purchase and the rounded dollar amount.
When the customer is using ‘Credit’ or ‘Debit’ cards as MOP, they will be presented with three preset contribution amounts configured in configuration client or two preset contribution amounts and a “round to next dollar” option.
The chosen selection is shown on the receipt, where it reflects the contribution. Only one charity can be active for any site.
Prompt Only Outside
Released
Base057.01.00 · PCS v1.26.0
Before this feature, the Charity prompt appeared during both indoor and outdoor transactions whenever charity was enabled. There was no way to restrict the charity prompt for outdoor only.
This feature introduces two new settings that independently control whether customers are prompted to donate during indoor transactions:
Cash Indoor — turn off the charity prompt for indoor cash transactions.
Network / Card Indoor — turn off the charity prompt for indoor card or network transactions.
Both settings default to enabled, so existing behaviour is fully preserved after upgrading. The existing outdoor control for card transactions was already available; this feature adds the matching indoor controls.
Primary use case: Commission Agent environments where the oil company controls the outdoor fuel transaction experience but does not want to require the indoor store agent to participate in charity prompting.
Configuration Settings
Three settings control when the charity prompt appears.
Cash Payment Options
Prompt Indoor
Yes / No
Yes (enabled)
Cash indoor charity prompt
Network Payment Options
Prompt Indoor
Yes / No
Yes (enabled)
Card/network indoor charity prompt
Network Payment Options
Prompt Outdoor
Yes / No
Yes (enabled)
Card/network outdoor charity prompt (pre-existing)
Note: These settings only take effect when the Charity Program is enabled. If charity is disabled entirely, no prompt appears regardless of these settings.
Backward compatibility: Older configurations that do not include the Prompt Indoor setting will behave as if it is set to Yes (enabled). No changes are needed to existing configurations.
Troubleshooting
Charity Prompt Still Appears Indoors
Check that the Prompt Indoor setting is set to No in the configuration.
Configuration Imported Successfully but Setting Not Saved
Confirm the site is running Base057.01.00 or later. The Prompt Indoor setting did not exist in earlier versions.
Updating the Charity Configuration
POS
After any changes to the configuration, go to Configuration Client > Tools > Refresh Configuration for the configuration changes to be applied.
PIN Pad
To send the configuration changes to PIN pad, log out and back into the POS.
DCR
For sending configuration updates to DCRs, do a DCR initialization from Configuration Client > Forecourt > Initialization > DCR.
Using Charity
PIN Pad Charity Prompt Examples
The prompt below shows two prompt options on the M400 PIN pad with a No Thanks button. The “Would you like to donate to Red Cross” is pulling the name 'Red Cross' from the charity department name. Press “No Thanks” or “Cancel” or red X sign on the keypad to complete payment without adding charity amount to the transaction.
DCR Charity Prompt Example
The charity prompt will appear before the customer fuels, and after swiping their card. Press the key next to No Thanks to complete the payment without adding charity amount to the transaction.
POS Cashier Prompt
The cancel prompt that shows up on the POS. This prompt is used to bypass the charity prompt if customers are confused.
Charity Donation Receipts
When the customer is using ‘Credit’ or ‘Debit’ cards as MOP, they will be presented with three preset contribution amounts configured in configuration client or two preset contribution amounts and a “round to next dollar” option.
The chosen selection is shown on the receipt, where it reflects the contribution. Only one charity can be active for any site.
Outdoor Receipt
Indoor Receipt
Reporting
Department Report all Cashiers
Department Report all Cashiers contains the number of transactions with charity and the total amount of charity collected during the period in the All Cashiers section.
Voided transactions are not counted in the charity reporting section.
Troubleshooting
Important Information
If you have issues with the feature, refer to this information.
Department not showing up in the charity drop down - check the product code number for the charity department.
I only have 2 options on my PIN pad - the PIN pad implementation only supports two options.
I configured two preset amounts for the PIN pad but only one shows up - confirm that the preset amounts are different. This includes preset 2 which is only used for DCRs. If the values are the same it will not display the value.
Charity is grayed out in configuration client - Check security levels of the user.
Cash MOP is not getting the Charity prompt - Make sure that "Tender Amount Required” is enabled for Cash MOP.
Last updated
Was this helpful?