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

To determine which eCommerce solution you are on, see How do I know if I am using Native eCommerce or Third Party eCommerce?

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:

1. Go to Paygate and click Client Login.
2. Click Login under VCS Virtual Terminal.
3. Go to Merchant Administration and then VcsInterfacing.
4. 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).
5. Set HttpMethod to POST.
6. Click Save.
7. Go to MerchantAdministration and then CallbackSettings.
8. 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).
9. Set CallBackProtocol to HTTPS and set CallBackMethod to POST.
10. Set ResponseFormat to NameValuePairs.
11. Click Save.
12. Go to MerchantAdministration and then Vcs Interfacing.
13. Enter MerchantPAM (Personal Authentication Message).
14. 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:

1. Click eCommerce then Manage Store.
2. Click Payment.
3. Select VirtualCardServices from the Choose Payment Method dropdown menu.
4. Enter your terminal ID, Secret word, and PAM.
5. 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 NumberCVC & Expiry DateFixed simulated authorization response4242424242424242Use any CVC number, e.g. 123. Use any valid expiry date.

123456Approved where 123456 = any alphanumeric value5454545454545454123456Approved where 123456 = any alphanumeric value5221001010000024 Call5221001010000032Invalid Expiry5221001010000040No 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.