VulaCoin

VulaCoin is a Splynx add-on which allows refilling of customer balance and paying invoices via the VulaCoin payment gateway - https://www.vulacoin.com/.

The add-on can work with various credit cards and bank accounts, payment details can be added or selected during the payment process.

Add-on installation

The add-on can be installed in two methods, via the CLI or the Web UI of your Splynx server.

To install the VulaCoin add-on via CLI, the following commands can be used:

apt-get update
apt-get install splynx-vulacoin

To install it via the Web UI:

Navigate to Config → Integrations → Add-ons:

1.png

Locate or search for the splynx-vulacoin add-on and click on the Install icon in the Actions column:

2.png

Click on the OK, confirm button to begin the installation process:

3.png

Add-on settings

After the installation process has completed, you have to configure add-on, navigate to Config → Integrations → Modules list:

4.png

Locate or search for the splynx-vulacoin add-on and click on the edit (Edit) icon in the Actions column:

5.png

Main information & API settings

Make sure that Entry points option is enabled. Note that changes are not saved until you click Save.

The configuration of add-on Entry points can be found in Config → Integrations → Modules list, near the splynx_vulacoin_addon module item in Actions column, click on the entry_point (Edit entry points) icon. More information about Modules list can be found here.

6.png

Vulacoin credentials & Merchant details

The add-on credentials can be obtain from your VulaCoin account.

7.png

Common settings

8.png

Invoice payment

Once the configuration has been completed, a customer can navigate to their Portal and pay for their (proforma) invoices using the VulaCoin icon under Finance → (Proforma) Invoices or using the corresponding widget (entry point) on the Dashboard.

In addition, a customer can add money to their account balance from the Dashboard page or use the following link - https:///vulacoin.

9.png

10.png

11.png

12.png

To pay with EFT means to use the electronic funds transfer or direct deposit, in other words, it's a digital movement of money from one bank account to another. The following banks are supported:

12.1.png

13.png

If everything goes well, you will see the status of invoice marked as Paid (on the customer and admin portals):

14.png

15.png

16.png

In case of problems during the payment, navigate to Administration → Logs → Vulacoin Logs to check the error message, e.g.:

17.png

Direct payments

Using the payments links is the simplest way to accept payments made with credit card or bank account. This feature is available in the VulaCoin add-on to pay Invoices and Proforma Invoices. This provides convenience and simplicity for your customers, so the amount of on-time payments will increase.

For example, you can add a payment link to the e-mail with the (proforma) invoice, as a result, the customer can make payment quickly by clicking onto such link instead of logging in to their Portal page.

To create a direct payment link, please use the patterns below:

To pay the Invoice:

by invoice ID
https://<splynx_domain_address>/vulacoin/direct-pay-invoice-by-id?item_id=<invoice_id>

by invoice number
https://<splynx_domain_address>/vulacoin/direct-pay-invoice?item_id=<invoice_number>


To pay the Proforma Invoice:

by proforma invoice ID
https://<splynx_domain_address>/vulacoin/direct-pay-proforma-by-id?item_id=<proforma_id>

by proforma invoice number
https://<splynx_domain_address>/vulacoin/direct-pay-proforma?item_id=<proforma_number>

Required Permissions

For the payment system to work properly, Splynx needs to have access to some external services. Therefore, these hosts should not be blocked by firewall rules:

Whitelist URLs
vulacoin.com
*.vulacoin.com
api.ravepay.co
*.bankserv.co.za
*.cardinalcommerce.com
*.capitecbank.co.za
oppwa.com
*.absa.co.za
*.africanbank.co.za
*.bidvestbank.co.za
*.fnb.co.za
*.investec.com
*.nedbank.co.za
*.sasfin.co.za
*.standardbank.co.za
*.ubank.co.za
3dsecureprd.fnb.co.za
acs.nedsecure.co.za
*.bankserv.co.za
*.ctpe.net
ctpe.net
ppipe.net
*.ppipe.net
*.capitecbank.co.za
secure.stitch.money
eu-prod.oppwa.com