Knowledge base
Guides
Academy
Video tutorials
Try searching for:
Recently viewed articles:

Table of contents

Virtual Card Services (VCS)

Virtual Card Services (VCS) is a payment service provider for all the major banks in South Africa and for the State Bank of Mauritius. You can use VCS to accept payments in your Ecwid online store.

Setting up your Virtual Card Services account

To integrate Virtual Card Services into your Ecwid store, you need to set up a VCS account.

To set up your Virtual Card Services account:

  1. Log in to your VCS account at PayGate, Client Login → VCS Virtual Terminal → Login.
  2. Go to Merchant Administration → Vcs Interfacing.
  3. Set the merchant’s approved and declined URLs to: https://app.ecwid.com/vcs/STORE_ID (where STORE_ID is your Store ID).
  4. Set Http Method to POST.
  5. Save the changes.
  6. Go to the Merchant Administration → Callback Settings.
  7. Set the merchant’s approved and declined URLs to: https://app.ecwid.com/vcs/STORE_ID (where STORE_ID is your Store ID).
  8. Set CallBack Protocol to HTTPS and CallBack Method to POST.
  9. Set Response Format to Name Value Pairs.
  10. Save the changes.
  11. Go to Merchant Administration → Vcs Interfacing.
  12. Enter Merchant PAM (Personal Authentication Message). It’s a security feature used to confirm that the response is from VCS.
  13. Send an email to vcssupport@paygate.co.za with your secret word and quoting your "VCS Terminal ID", requesting that the Hash Type be set to MD5.

Enabling Virtual Card Services in your Ecwid store

After you set up your Virtual Card Services account, you can integrate the payment method into your Ecwid store.

To enable Virtual Card Services in your Ecwid store:

  1. From your Ecwid admin, go to Payments.
  2. Scroll down to More options to accept online payments and choose Virtual Card Services from the dropdown.
  3. On the opened page, enter your Virtual Card Services terminal ID, Secret word, and Merchant PAM:

    VCS.png

  4. In the Appearance options block, turn on the Enable this payment method at checkout toggle.
  5. (optional) In the Payment method name at checkout field, change the name of the payment method that your customers see.
  6. (optional) Click Set payment instructions at checkout‍ to add any guidance for your customers about the payment method.
  7. (optional) Click Limit availability by shipping method to‍ link the Virtual Card Services payment method with any particular shipping method.
  8. Click Save.

That’s it! Now you can accept payments from your customers with Virtual Card Services.

Before going live with Virtual Card Services, make sure the currency in your Ecwid store is the same as in your Virtual Card Services account. You can set up currency in Settings → General → Regional Settings.

Testing Virtual Card Services

New merchants loaded on the Virtual Card Services system have access to the VCS Test platform. Virtual Card Services 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.

Accepting payments with Virtual Card Services

After you enable Virtual Card Services in your Ecwid store, your customers will be able to choose this payment option at the checkout. Then they will have to fill in their payment information to place an order.

You can always check what payment method has been used for an order by viewing an order’s details in your Ecwid admin → My Sales → Orders. For Virtual Card Services, you will see Virtual Card Services in the payment details. You can easily find all orders paid through Virtual Card Services by using the order filters in your store admin.

Related articles

Placing a test order
How to make your first sale

Was this article helpful?

Awesome! Thanks for your feedback!

Thanks for your feedback!

Sorry about that! What went wrong?
22 out of 47 found this helpful
10
We use cookies and similar technologies to remember your preferences, measure effectiveness of our campaigns, and analyze depersonalized data to improve performance of our site. By choosing «Accept», you consent to the use of cookies.
Accept cookies Decline