Skip to content

Plugins

The e-commerce plugins your merchants use to connect their webshops to your platform: which there are, how you get them in your brand, and how you support merchants who use them.

Merchants whose webshop runs on an e-commerce platform, such as WooCommerce or Shopify, connect to your platform with a plugin instead of their own integration. The merchant installs the plugin and enters the API key of its project; the plugin creates the orders, sends customers to the hosted payment page and updates the order in the webshop.

Ginger builds and maintains the plugins. Your merchants get them in your brand, connected to your platform.

How a plugin works

sequence diagram

The customer pays on the hosted payment page, so card data never reaches the webshop.

The plugins

PlatformHow the merchant gets it
WooCommerceA package of the plugin in your brand
ShopifyA payments app in your brand, installed from Shopify. See Shopify
Magento 2A package of the plugin in your brand
PrestaShop 1.7 and 8A package of the plugin in your brand
OpenCart 3A package of the plugin in your brand

Ask your Ginger contact which plugins are available for your platform, and for which versions of each e-commerce platform.

Get the plugins in your brand

Ginger builds each plugin for your platform: with your brand name and connected to your platform, so your merchants never see Ginger. You receive a package of each version, and publish it for your merchants, for example on your website or in your help centre.

The Shopify app works differently: it's published in Shopify under your own Shopify Partner account. See Shopify.

What you do for merchants with a plugin

  • Switch on the payment methods in the merchant's project. A plugin only offers the payment methods, and the currencies, that the project allows. See Processor contracts.
  • Give the merchant its API key, of the test project first and of the live project when it goes live. The merchant enters it in the plugin settings.
  • Send new versions to your merchants when Ginger releases them. Merchants update the plugin themselves.

Your merchants' instructions, from installing the plugin to going live, are in the payment acceptance docs.

See which plugin a merchant uses

In the Admin portal, open the merchant's project: it shows the platform name and version, and the plugin name and version, of the last completed order. Use them when a merchant asks for help.

Support merchants

You support your merchants with their plugin. When you can't solve a problem, contact Ginger support with:

  • The plugin and its version, and the e-commerce platform and its version.
  • The other plugins installed in the webshop.
  • The ID of an order or transaction that shows the problem, and screenshots.

A customer paid, but the order stays unpaid

After a payment, your platform sends a webhook to the webshop, and the plugin updates the order. A firewall or bot protection in front of the webshop can block the webhook: the order then stays unpaid, and some platforms cancel it after a while. Ask the merchant to allow the webhook traffic of your platform, and to place a test order to check that the status updates by itself.

WooCommerce shows no payment methods

The WooCommerce plugin only shows a payment method when it can confirm that the project accepts the currency of the webshop. Check the currencies of the payment method in the merchant's project. When it's fixed, the merchant switches the payment method on again in the WooCommerce settings.

Next steps