VCS payment

Last updated

Virtual Card Services is a Payment Service Provider for all the major banks in South Africa and for State Bank of Mauritius. 

How to set up

In order to enable and use Virtual Card Services as a payment option, please follow these steps: 

1. Go to https://www.vcs.co.za → Admin Login → Virtual Terminal → login → Merchant  Administration → 3. Vcs Interfacing (page 1). 


2. Go to the "Merchant Administration → 6. Callback Settings" page


  •  Set the merchant’s approved and declined URLs to: http://app.ecwid.com/vcs/STORE_ID (where STORE_ID is your Store ID).
  •  Set "CallBack Protocol" to "HTTPS"
  •  Set "CallBack Method"  to "POST"
  •  Set  "Response Format" to "Name Value Pairs"
  •  Save the changes. 

3. Then please go to the "Merchant Administration → 4. Vcs Interfacing (page2)". Enter Merchant PAM. PAM stands for Personal Authentication Message, a security feature to confirm that the response is from VCS.

4. Send an email to support@vcs.co.za with your secret word and quoting your "VCS Terminal ID", requesting that the "Hash Type" be set to "MD5".

5. Go to Ecwid control panel. Open Settings → Payment page. Select the Virtual Card Services payment processor for the Credit Card payment method. Save the changes.

Click the Virtual Card Services "Account details" link. Enter your Terminal ID, Secret word and Merchant PAM. Save the changes and enable this payment method.

Notes

Please make sure that your store's currency is the same as your VCS account's one. Otherwise your payment gateway will not work.

How to test it

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 authorisation 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”.

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.

Was this article helpful?
1 out of 3 found this helpful
Questions?
Get help
  • Forums

    Join the Ecwid community. Discuss support topics and store ideas with other Ecwid users.

  • Contact us

    Still have questions about Ecwid? Let us know! We will be glad to help you with your Ecwid store.

  • Status Monitor

    Get real time status updates on Ecwid services here, 24/7