Payments without the hasslePersonal advice: 085 560 12 01
WordPress & WooCommerce

Installing the WooCommerce plugin.

Upload the plugin, enter your terminals with their API keys and make a test payment. After that, the customer in the webshop, or an employee from the order, can pay on the payment terminal.

Pin Vandaag for WooCommerce
WooCommerce→Pin Vandaag Cloud→Payment terminal
Version 1.0.3 · free download
Preparation

Before you start

  • WordPress 6.5 or higher, WooCommerce 7.0 or higher and PHP 7.4 or higher.
  • The webshop checks out in euros. In another currency, WooCommerce does not show the payment method.
  • You need administrator rights in WordPress to install plugins.
  • A CCV or Worldline payment terminal with an active Pin Vandaag cloud connection, with the TMS number and the corresponding API key.
  • Preferably a webshop on HTTPS: only then does the API send the result back directly via the webhook.
Security: treat the API key like a password. Do not share it in screenshots, public tickets or unsecured e-mail. The plugin never writes the API key to the log.
Step 1

Install and activate the plugin

  1. Download pin-vandaag-for-woocommerce-1.0.3.zip. Do not unzip the file.
  2. In WordPress, go to Plugins › Add New Plugin and click Upload Plugin at the top.
  3. Choose the zip file and click Install Now.
  4. Then click Activate Plugin. The list now shows Pin Vandaag voor WooCommerce.
Verifying the download: the SHA-256 of version 1.0.3 is a0ea544107722ce6ffb86493c7371a3fdfa9c6324c362e5a83413a81fe2666ce.
Step 2

Enter your terminals and API keys

  1. Go to WooCommerce › Settings › Payments and open Pin Vandaag (pinautomaat). You can also click Settings next to the plugin.
  2. In PinPortal.nl, look up the TMS number and API key for each terminal, under customer settings › Overige (other) tab › API Keys.
  3. Under Terminals, enter one terminal per line, separated by a vertical bar. The name is optional and is shown in the terminal selection.
TMS number|API key|name 50303253|your-api-key-shop|Shop till 706249441|your-api-key-warehouse|Warehouse till
  1. Leave Default terminal ID (Standaard terminal-ID) empty to use the first terminal from the list, or enter the TMS number of another terminal.
  2. Under Terminal selection at checkout (Terminalkeuze bij afrekenen), choose whether the default terminal is always used, or whether the customer or employee chooses a terminal.
  3. Click Save changes and then Test connection with all terminals (Test verbinding met alle terminals). Each terminal should show a tick.
General API key: this field is only a fallback for lines without their own API key, such as the old format TMS number|name from version 1.0.0. For new installations, you can leave it empty.
Step 3

Decide where and how payments are made

  1. Switch on Enable Pin Vandaag payment terminal (Pin Vandaag pinautomaat inschakelen).
  2. Under Available in (Beschikbaar in), choose where paying via the payment terminal is possible: Shop checkout (the customer pays during checkout) and/or Admin area (an employee sends an order to the terminal). Existing card transactions always remain visible with the order.
  3. Leave Test mode (Testmodus) on while you are testing. In the checkout, only logged-in administrators and shop managers will then see the payment method.
  4. If you wish, adjust the Title and Description that the customer sees in the checkout.
  5. Under Processing (Verwerking), set how often the status is requested (5 seconds by default), after how many seconds a payment is cancelled (180 by default), which status a paid order receives and whether the card receipt is shown or e-mailed.
Collection at the counter? Under Status after successful payment, choose Always completed; then you no longer need to complete the order after the card payment.
Step 4

Make a test payment

  1. Log in as an administrator, put an inexpensive product in the basket and choose Pinnen op de pinautomaat (pay on the payment terminal) at checkout.
  2. After placing the order, you will see a waiting page. The amount appears on the terminal.
  3. Complete the payment on the terminal. The waiting page continues to the thank-you page, with the card receipt if that option is on.
  4. Check in WooCommerce that the order has been paid and that the transaction and card receipt are shown in the Pin Vandaag pinautomaat block.
  5. Also test Send … to terminal for an open order via the admin area, if you use that option.
  6. If everything works, switch off Test mode. From that moment on, customers will see the payment method.
Refunds: a refund from WooCommerce is started on the terminal. The customer must present their card for this. The result appears as a note on the order.
Maintenance

Updating the plugin

  1. Download the latest zip from pinvandaag.nl/woocommerce. The version number is in the file name.
  2. Go to Plugins › Add New Plugin › Upload Plugin and upload the new zip.
  3. WordPress reports that the plugin is already installed and shows the current and the new version. Choose the button to replace the current version with the uploaded version.
  4. Under Plugins, check that the new version number is shown for Pin Vandaag voor WooCommerce.
Your settings, terminals and API keys are kept when updating. You do not need to remove the plugin first.
One-off when moving from 1.0.2 or earlier to 1.0.3: from 1.0.3 onwards, the plugin has a new folder name. WordPress therefore installs the new version alongside the old one and shows a message that the plugin is installed twice. Deactivate and delete the old Pin Vandaag voor WooCommerce with version 1.0.2 or lower. Your settings are kept.
Initial check

Troubleshooting

The payment method is not shown in the checkout

Check that the plugin is enabled, that Shop checkout is switched on, that at least one terminal has been entered and that the webshop checks out in euros. If test mode is on, only a logged-in administrator sees the payment method.

The connection test shows a cross

Check that the TMS number and API key belong together, that there are no spaces in them and that the terminal is online. Save the settings before testing again.

No amount appears on the terminal

Do not start several payments in a row. Check the status in the block on the order and, if necessary, cancel an open payment.

Something goes wrong and you want to know more

Switch on Debug log and view the log under WooCommerce › Status › Logs, source pinvandaag. Then switch it off again.

Need help with the installation?

Have your WordPress and WooCommerce version, the terminal model and the TMS number to hand. Only share your API key via an agreed secure channel.

Contact us