Plugins
Accept payments in your webshop on an e-commerce platform, such as WooCommerce, with a Ginger Payments plugin and without writing code.
If your webshop runs on an e-commerce platform, a plugin connects it to Ginger Payments without code. You install the plugin, enter your API key and choose the payment methods. The plugin creates the orders, sends your customers to the hosted payment page and updates the order status in your webshop.
Because your customers pay on the hosted payment page, card data never reaches your webshop.
How it works
Get your test API key
- Log in to the merchant portal at https://merchant.dev.gingerpayments.com.
- Go to Settings > Project and copy the API key.
Install the plugin
Install the Ginger Payments plugin for your platform from the platform's marketplace, or the package you received from Ginger Payments. Which platforms have a plugin depends on your agreement: ask Ginger Payments support.
Configure the plugin
In the plugin settings of your webshop:
- Enter the API key of your test project.
- Turn on the payment methods you want to offer. Only payment methods that are active in your project work.
Place a test order
Place an order in your webshop and pay with a test card from Test data. The order status in your webshop changes to paid within a few seconds, without any action from you.
Go live
- Make sure your live project is active, with the payment methods you need.
- Replace the test API key in the plugin settings with the API key of your live project.
- Place a small real order and refund it.
Troubleshooting
A customer paid, but the order stays unpaid or is cancelled
After a payment, Ginger Payments sends a webhook to your webshop, and the plugin updates the order. A firewall, web application firewall or bot protection in front of your webshop can mistake the webhook for a bot and block it. The order then stays on "Pending payment", and some platforms cancel it automatically after a while.
- Allow the webhook traffic in your firewall or security settings. Contact Ginger Payments support for the IP addresses of the webhook servers.
- Place a test order and check that the order status updates automatically.
If it still doesn't update, send Ginger Payments support the ID of the transaction.
WooCommerce marks an order "Failed" instead of "Cancelled"
That's expected when your customer closes the payment page or cancels the payment. WooCommerce reserves "Cancelled" for orders a store admin cancels, so the plugin uses "Failed" for a payment that wasn't completed.