> For the complete documentation index, see [llms.txt](https://commanderhelp.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://commanderhelp.verifone.com/feature-references/features-and-products-references/charity-donations.md).
# Charity Donations
### Revision History
Date
Description
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.
{% hint style="info" %}
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.
{% endhint %}
### Charity Donation Configuration
Use **Store Operations > Charity Donations** in Configuration Client and **Store Operations > Charity Donations** in Verifone Central to configure Charity Configuration.
{% hint style="info" %}
If the charity department does not have NACS product code 971 assigned, it will not appear in the Department drop-down in this form.
{% endhint %}
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.
{% hint style="info" %}
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.
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.
{% hint style="info" %}
Note: These settings only take effect when the Charity Program is enabled. If charity is disabled entirely, no prompt appears regardless of these settings.
{% endhint %}
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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://commanderhelp.verifone.com/feature-references/features-and-products-references/charity-donations.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.