Group Gift & Shared Payment (dfgiftpot)

Overview

The Group Gift & Shared Payment module lets your customers fund a common gift together. A customer creates a pot from a product page or their cart, shares a unique link, and each participant actually pays their share through the payment methods already active on your store. At closing, a discount voucher matching the collected amount is automatically issued to the organizer.

The module is compatible with PrestaShop 8.0 to 9.x, multistore, with no Composer and no external dependency.

Installation

1. In your back office, open Modules then Module Manager.
2. Click Upload a module and drop the dfgiftpot.zip file.
3. Once installed, click Configure to set up the module.

Module settings

The configuration page gathers the following parameters:

• Minimum contribution: the floor amount for a contribution (default 5).
• Maximum contribution: the cap for a contribution (0 = unlimited).
• Default duration: number of days before a pot expires.
• Voucher validity: validity, in days, of the voucher issued at closing.
• Button on the product page: shows a “Create a pot” button on product pages.
• Button from the cart: shows a “Create a pot” button in the cart.
• Open pots: allows creating pots with no target product.
• Automatic closing: closes the pot as soon as the goal is reached.
• Terms: notice shown to the participant before contributing.

How a pot works

The mechanism relies on a real capture of each contribution:

1. A customer creates a pot (targeting a product, or open) and optionally sets a goal.
2. They share the public link of the pot with participants.
3. Each participant enters an amount. The module creates a dedicated cart for them containing the “Pot contribution” product priced at the exact share, then sends them to the native checkout.
4. Once payment is validated, the contribution is marked as paid and added to the total collected.
5. When the goal is reached (automatic closing) or on manual closing, a discount voucher for the collected amount is generated and emailed to the organizer.

Customer side

Create a pot

From a product page or their cart, the customer clicks “Create a pot”, fills in a title, an optional goal and a deadline, then confirms. Creating a pot requires a customer account.

Participate

A participant opens the pot link, enters their amount, name and email (a message and the anonymous option are available), then pays their share. No account is needed to participate.

Share

The pot page offers a unique link and a “Copy” button to spread it easily.

My pots

The organizer finds their pots in their customer account, where they can track progress, close or cancel.

Merchant side (back office)

A Pots tab is added to the Customer menu. It lists all pots with their organizer, goal, amount collected, status and deadline. The detailed view shows the list of contributions and lets you close or cancel a pot manually.

Emails sent

• New contribution: sent to the organizer on each paid contribution.
• Pot closed: sent to the organizer at closing, with the voucher code.

The templates are provided in French and English and can be customized from PrestaShop’s email translation.

Issued voucher

At closing, the module generates a single-use cart rule, restricted to the organizer’s account, whose code follows the format “POT-” followed by a token and the pot identifier. The voucher matches the collected amount and can be used according to PrestaShop’s standard discount voucher rules.

Frequently asked questions

Can a pot be created without a product?

Yes, if the “Open pots” option is enabled in the settings.

What happens if a contribution exceeds the goal?

When a goal is set, the last contribution is automatically capped at the remaining amount.

Uninstallation

Uninstalling from the Module Manager removes the pot and contribution tables as well as the configuration. Back up your data beforehand if you wish to keep it.