# Charity Donations

## Using This Feature Reference

This Feature Reference provides detailed information on how to configure and use the Charity Donation feature.

* Overview - This section contains a brief description, requirements and the supported hardware configurations for the Charity Donations feature.
* Configuring - This section contains information on how to configure the Charity Donations feature.
* Using - This section describes how to prepare the Verifone Commander for the Charity Donations feature.
* Reporting - This section contains a sample report with a detailed report description for the Charity Donations feature.

### Revision History

<table><thead><tr><th width="166">Date</th><th>Description</th></tr></thead><tbody><tr><td>07/07/2025</td><td>Initial Documentation Release.</td></tr><tr><td>08/06/2025</td><td>Updated with review comments.</td></tr></tbody></table>

## 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.

<figure><img src="/files/XwV1cGn3BgPnDOUadqfp" alt=""><figcaption></figcaption></figure>

### 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 %}

<figure><img src="/files/OPHKHOoJkjTRLJcBnR4u" alt=""><figcaption></figcaption></figure>

### Charity Donation Configuration

Go to Configuration Client > Store Operations > Charity Donations.

<figure><img src="/files/mgQ5nKEpdimt2hTOpeMD" alt=""><figcaption></figcaption></figure>

{% 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.

<p align="center"><img src="/files/4OxJLdCIrw9l0dRdnV5u" alt=""></p>
{% endhint %}

| Field/Button             | Description                                                                                                                                                                                                                                                                                                                                     |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable Charity Donations | <p>Enables the Charity Donations program. </p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Note: When Enable Charity Donations is selected, by default Prompt Indoor is selected and cannot be edited.</p></div>                                                                                       |
| Department               | <p>Select the charity department. </p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If the charity department does not have NACS product code 971 assigned, it will not appear in the Department drop-down in this form.</p></div>                                                                      |
| Cash                     | <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Cash is only available for indoor charity.</p></div>                                                                                                                                                                                                      |
| 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                     | <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Cards can be used for both Indoor and Outdoor charity.</p></div>                                                                                                                                                                                          |
| 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.

#### 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.

<figure><img src="/files/9ECsXafLfz8nLnNjiDHg" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="/files/KRsRxLCSnmbw6acGhxbj" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="/files/lFS3QtUb8ZuZOTLC8fXY" alt=""><figcaption></figcaption></figure>

### 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

<figure><img src="/files/6WdTvdqfqVuAQ3rWn97z" alt=""><figcaption></figcaption></figure>

#### Indoor Receipt

<figure><img src="/files/WIf4oSfdv8MXrrmONEKw" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="/files/et0E4qVclAkcZFEUoHZ9" alt=""><figcaption></figcaption></figure>

## 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: 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:

```
GET https://docs.verifone.com/feature-references/feature-references/charity-donations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
