Description

eGift lets Belgian merchants sell gift vouchers (cadeaubonnen) online. Buyers choose an amount or one of your experience vouchers, pay online and receive the gift voucher by e-mail. eGift handles the payment and the delivery, and pays you out. Your customers redeem it in your shop, with the eGift app or portal.

This plugin brings that to your WordPress site, without pasting code into a page.

Connect once. Under Settings > eGift, paste the code from the “Bon op uw eigen website” page in the eGift portal, or just your merchant ID. The plugin shows which eGift account it is connected to and what is still missing before buyers can buy your gift vouchers (company details, logo, banner), with a link to each step.

Place the eGift Widget anywhere. The Widget is where buyers choose and pay for a gift voucher. Put it on a page with:

the “Create a Gift voucher page” button under Settings > eGift, which publishes a page with the Widget, ready to add to your menu;
the eGift Widget block in the block editor;
the shortcode [egift] in page builders without blocks, for example [egift accent="#c0392b" experience="12"].

Make it yours. Give the Widget’s buttons the accent color of your site (in the block, the shortcode or the page button), and sell one of your experience vouchers on a page of its own.

Accept gift vouchers in your WooCommerce shop. Create an API-sleutel (API key) in the eGift portal and paste it under Settings > eGift. Buyers then get a “Gift voucher” field in the cart and the checkout, classic or block-based. A voucher pays like a payment method, not a discount: it lowers the amount to pay, shipping included, and leaves the item lines and VAT as they are. Several vouchers can pay one order; the buyer pays the rest as usual. Once the order is paid, eGift takes the amount off each voucher and shows it with the order number in your eGift portal. Refunding the order puts the voucher part back on the voucher. The shop currency must be euro.

The plugin is free. You need an eGift account, which you can create for free at egift.be. eGift charges its usual commission on each gift voucher sold. The plugin works with or without WooCommerce.

The plugin’s screens are in English. Their Dutch (Belgium) and Dutch (Netherlands) translations come through translate.wordpress.org.

External services

This plugin relies on eGift (https://egift.be), the service that sells your gift vouchers. Without it the plugin does nothing. It contacts egift.be only in these cases:

Merchant lookup: when you save your code, open Settings > eGift or add the eGift Widget block, the plugin sends your merchant ID to fetch your company name, the steps still missing in your eGift account and your experience vouchers.
API-sleutel check (WooCommerce): when you save an API-sleutel and when you open Settings > eGift, the plugin sends the key to check that it is still valid and to fetch its name and your company name.
Gift voucher lookup (WooCommerce): when a buyer enters a gift voucher code in the cart or checkout, and again when they place the order, the plugin sends that code with your API-sleutel to check that the voucher is valid in your shop and to fetch its credit.
Inwisseling (WooCommerce): once an order paid with a gift voucher is paid, the plugin sends the voucher code, the amount it pays and the order number with your API-sleutel, and eGift takes that amount off the voucher. The order number shows next to the voucher in your eGift account.
Terugboeking (WooCommerce): when you refund such an order and put an amount back on the gift voucher in the refund screen, the plugin sends the voucher code, eGift’s reference of the Inwisseling and that amount with your API-sleutel, and eGift puts it back on the voucher.
Status report: only while your site is connected, when you save the settings and once a day, the plugin sends your merchant ID, this site’s address, the versions of the plugin, WordPress, PHP and WooCommerce, and whether buyers can pay with gift vouchers in your shop, with your API-sleutel if one is saved. eGift keeps only the latest report, so its support can help you without asking. Deactivating the plugin stops it.
The Widget: on pages with the eGift Widget block or the [egift] shortcode, the visitor’s browser loads https://egift.be/js/embed.js, which shows the Widget from egift.be in a frame. The Widget receives your merchant ID, the chosen accent color and experience voucher, and the address of the page, so a buyer returns there after paying. What a buyer enters to buy a gift voucher goes to eGift, under eGift’s terms and privacy policy.
Creating an account: the “Create a free account” link under Settings > eGift opens the eGift registration page in your browser. The link tells eGift that the account comes from this plugin; nothing else is sent until you register.

The plugin itself never sends a buyer’s name, address or other personal details to egift.be.

eGift terms of use: https://egift.be/voorwaarden/algemene-voorwaarden
eGift merchant terms: https://egift.be/voorwaarden/handelaar-voorwaarden
eGift privacy policy: https://egift.be/privacy

Screenshots

Settings > eGift: paste your code and see which steps are still missing before buyers can buy your gift vouchers.

Once everything is done, one click creates a "Cadeaubon" page with the eGift Widget in your accent color. — Settings > eGift: paste your code and see which steps are still missing before buyers can buy your gift vouchers.

Installation

In WordPress, go to Plugins > Add Plugin, search for “eGift”, then install and activate the plugin.
Go to Settings > eGift. No eGift account yet? Click “Create a free account” there first.
In the eGift portal, open “Bon op uw eigen website”, copy the code and paste it under Settings > eGift. Your merchant ID alone works too. Click Save.
Finish any steps the plugin lists as still missing, in the eGift portal.
Click “Create a Gift voucher page” and add the page to your menu, or add the eGift Widget block to a page of your choice.
WooCommerce shop? In the eGift portal, create an API-sleutel under Verkoop > API-sleutels and paste it under Settings > eGift, in the Webshop part.

FAQ

Do I need an eGift account?

Yes. The plugin places the eGift Widget of your eGift account on your site. Creating an account is free: use the “Create a free account” link under Settings > eGift, or register at egift.be.

What does it cost?

The plugin is free. eGift charges its usual commission on each gift voucher sold through the Widget, exactly as for a sale on egift.be. See the eGift merchant terms.

Where do I find my code?

In the eGift portal, on “Bon op uw eigen website”, under “Plak deze code op uw pagina”. Your merchant ID alone works as well.

Does it work with my page builder?

Use the eGift Widget block in the block editor. In page builders without blocks, put the shortcode [egift] in a text or shortcode element.

Can I sell one experience voucher on a page of its own?

Yes. Choose it in the block’s settings, or add its ID to the shortcode: [egift experience="12"]. The IDs are on the “Bon op uw eigen website” page in the eGift portal.

Where do buyers pay, and what does my site store?

Buyers choose and pay inside the Widget, which egift.be shows in a frame on your page. No payment or buyer data passes through your site. The plugin stores your merchant ID, your API-sleutel and which page it created, and nothing about your visitors.

Why does the Widget not show on my page?

Check Settings > eGift. If the site is not connected yet, logged-in administrators see a hint on the page and visitors see nothing. If steps are still missing in your eGift account, finish them in the eGift portal first.

What if a gift voucher has less credit left when the order is paid?

eGift takes what is left, and the order goes on hold with a note of the amount still to collect from the buyer.

Can a developer keep some products from being paid with a gift voucher?

Yes, with the egift_eligible_amount filter; there is no setting for it. It receives the part of the cart total that gift vouchers may pay (the whole total with shipping and taxes) and the cart, and can only lower that part. For example, to leave out the category “wine”:

add_filter( 'egift_eligible_amount', function ( $eligible, $cart ) {
    foreach ( $cart->get_cart() as $item ) {
        if ( has_term( 'wine', 'product_cat', $item['product_id'] ) ) {
            $eligible -= $item['line_total'] + $item['line_tax'];
        }
    }
    return $eligible;
}, 10, 2 );

The buyer pays the rest with another payment method.

A gift voucher pays a different amount than I expect. How do I find out why?

Turn on the diagnostics mode under Settings > eGift. Logged-in administrators then see in the cart and the checkout each step from the cart total to the amount to pay, and the active plugins. A discount or pricing plugin is the usual cause. Buyers never see it.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“eGift.be” is open source software. The following people have contributed to this plugin.

Translate “eGift.be” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.1.2

Says API-sleutel, like the eGift portal, and links to that page.

0.1.1

Connect your site to your eGift account and place the eGift Widget with a block, the [egift] shortcode or a ready-made “Gift voucher” page.
WooCommerce: buyers pay with their eGift gift vouchers in the cart and checkout, classic or block-based, several per order.
The amount comes off the voucher once the order is paid, and goes back on it when you refund the order.
A diagnostics mode, and the egift_eligible_amount filter for developers.

Description

External services

Screenshots

Installation

FAQ

Do I need an eGift account?

What does it cost?

Where do I find my code?

Does it work with my page builder?

Can I sell one experience voucher on a page of its own?

Where do buyers pay, and what does my site store?

Why does the Widget not show on my page?

What if a gift voucher has less credit left when the order is paid?

Can a developer keep some products from being paid with a gift voucher?

A gift voucher pays a different amount than I expect. How do I find out why?

Reviews

Contributors & Developers

Interested in development?

Changelog

0.1.2

0.1.1

Meta

Ratings

Contributors

Support