The Virtual Card Services (VCS) Virtual Terminal extension allows you to accept payments on your WooCommerce site using the South African payment processing platform.
Customers are directed to your merchant account on the VCS website to complete payment with their credit card, then returned to your website where they can continue browsing.
- An active VCS Virtual Terminal account
- South African Rand (ZAR) set as your store’s currency
- Download the .zip file from your WooCommerce account.
- Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
- Install Now and Activate the extension.
More information at: Install and Activate Plugins/Extensions.
- Go to: WooCommerce > Settings > Payments.
Note: ‘Payments’ formerly called ‘Checkout’ prior to WooCommerce 3.4.
- Select Virtual Card Services. You are taken to the Settings screen.
- Configure your settings:
- Enable/Disable – Enable to use. Disable to turn off.
- Title – Choose the title shown to customers during checkout
- Description – Add info shown to customers if they pay with VCS
- Terminal ID – Enter from your VCS account.
- Personal Authentication Message – Should be the exact same text in both your WordPress admin and VCS.
- Test Mode – Tick the box if in development or test mode. Untick to disable when ready to go live.
- Virtual Terminal Setup
- Website URL, Approved page URL and Declined page URL are provided for you to copy/paste into your VCS account (see below)
- Save changes.
A few areas of the VCS virtual terminal require basic setup.
- Go to: Merchant Administration.
- Select Section 3: VCS Interfacing (page1) once logged in.
- Enter Website URL, Approved page URL and Declined page URL.
- Set HTTP Method to POST.
- Visit VCS Interfacing (page2) and set your PAM to be the same message as Personal Authentication Message in your WordPress admin.
VCS needs to be in Test Mode by ticking the box when developing or testing; no live payments are taken. This is the default setting when a new terminal is created, and is shown by a red tag saying Test Mode in the top-left corner of your VCS Virtual Terminal.
When Test Mode is enabled in your WooCommerce settings, all transactions for VCS are logged on your server for reference during the testing period.
Remember to turn off test mode before processing live transactions on your store.
For testing purposes, VCS has provided the following test credit card credentials, each returning a specific response:
|Test Card Number||CVC & Expiry Date||Fixed Simulated Authorisation Response|
|4242424242424242||Use any CVC number,
e.g. 123.Use any valid expiry
|XXXXXXApproved where XXXXXX = any alphanumeric value|
|5454545454545454||XXXXXXApproved where XXXXXX = any alphanumeric value|
|5221001010000040||~No Active Connection to Acquirer exists|
According to the VCS Virtual Terminal documentation:
“Any valid credit card number can be submitted to the test platform during the test phase as
the transactions are not sent to the banks for authorization and no real money is involved,
VCS simulates the response that would be received from a bank.
The following responses occur randomly with any other card number used:
“Invalid Terminal”, “Declined”, “Invalid Expiry”, “Batch Full”, “Call”, “XXXXXXApproved”.
Please ensure that sufficient testing has been completed before requesting activation as
once a terminal has been activated it cannot be reset into Test status without the loss of any
live transactions that may have been processed.”
Already purchased and need some assistance? Get in touch with a Happiness Engineer via the Help Desk.