Use Virtual Card Services as Your Store Payment Provider (Third Party Store)

Modified on Fri, 18 Nov, 2022 at 9:56 AM

Virtual Card Services (VCS) is a Payment Service Provider for all the major banks in South Africa and for State Bank of Mauritius. To set up VCS as your payment provider you need to set up your VCS account then enable it as a payment provider for your site. After it is enabled you can test it.

To set up your Virtual Card Services account:

Go to Paygate and click Client Login.
Click Login under VCS Virtual Terminal.
Go to Merchant Administration and then VcsInterfacing.
Set the merchant’s approved and declined URLs to: https://app.multiscreenstore.com/vcs/STORE_ID (where STORE_ID is your Store ID. This can be found on your Dashboard).
Set HttpMethod to POST.
Click Save.
Go to MerchantAdministration and then CallbackSettings.
Set the merchant’s approved and declined URLs to: https://app.multiscreenstore.com/vcs/STORE_ID (where STORE_ID is your Store ID. This can be found on your Dashboard).
Set CallBackProtocol to HTTPS and set CallBackMethod to POST.
Set ResponseFormat to NameValuePairs.
Click Save.
Go to MerchantAdministration and then Vcs Interfacing.
Enter MerchantPAM (Personal Authentication Message).
Send an email to vcssupport@paygate.co.za with your secret word and quote your "VCS Terminal ID", requesting that the Hash Type be set to MD5.

To enable Virtual Card Services for your site:

Click eCommerce then Manage Store.
Click Payment.
Select VirtualCardServices from the Choose Payment Method dropdown menu.
Enter your terminal ID, Secret word, and PAM.
Click Save.

Note

Make sure that your Store's currency is the same as your VCS account's currency. Otherwise your payment gateway will not work.

How to Test

New merchants loaded on the VCS system have access to the VCS Test platform. VCS runs a response generator that has some fixed but mostly random responses.

Test Card Number	CVC & Expiry Date	Fixed simulated authorization response
4242424242424242	Use any CVC number, e.g. 123. Use any valid expiry date.	123456Approved where 123456 = any alphanumeric value
5454545454545454		123456Approved where 123456 = any alphanumeric value
5221001010000024		Call
5221001010000032		Invalid Expiry
5221001010000040		No Active Connection to Acquirer exists

Any valid credit card number can be submitted to the test platform during the test phase because no real money is involved. The following responses occur randomly with any other card number used: "Invalid Terminal", "Declined", "Invalid Expiry", "Batch Full", "Call", "123456Approved".

Note

Ensure that sufficient testing has been completed before requesting activation as once a terminal has been activated it cannot be reset into Test status.