Internet Data Cap

Internet Data Cap

Splynx has internet plans that we can configure to cap the client. It means that when a client reaches certain amount of data we will block him and will not allow access to the internet. Customer then can buy additional data,tThe Top up feature description is available here – https://splynx.com/3387/top-up-data/

Let’s say we are allowing 10 GB per month to the customer and when he reaches the limit, Splynx locks the access. Also plan can do a rollover of unused data to next month :

 

To update the service, you can top up the plan. For example, let’s set additional 5 GB for 10 $ or 10 GB for 15 $. The validity of the top can vary from unlimited to a couple of months.

 

It is always necessary to specify the notifications, as they inform customer about usage of the data plan. For example, Splynx can send email or SMS message to clients after reaching 80 per cent of the month limit.

 

So, what will happen if the client will download 100 MB after the traffic was overused? He will be blocked, and we can check it using simulation tool :

 

Please check the video showing CAP plans configuration below

 


Our engineers will always assist you in the proper configuration. Should you have any questions or further information is needed, please contact us or schedule a call with our engineer.

SEPA XML export

The Single Euro Payments Area (SEPA) is a payment-integration initiative of the European Union for simplification of bank transfers denominated in euro. Splynx is able to export invoices to SEPA, and can import after payments to set invoices as paid, or in case that payments were returnes, to se that invoices as unpaid. Read More

Splynx Radius configuration and troubleshooting

This is a post showing how to troubleshoot communication between router (Mikrotik example) and Radius.

Video tutorial for Radius configuration can be found here – https://splynx.com/384/ispframework-and-radius-mikrotik-example/. Below are steps for Radius and Splynx configuration:

Step 1. Mikrotik Radius section
To configure Mikrotik router and Radius authentication, we should change the settings in Mikrotik Radius section.
1) Choose services, that have to be authenticated by Radius (ppp, DHCP, login etc.)
2) Enter IP address = Splynx IP address, reachable from Mikrotik
3) Secret = this value is located at Splynx -> Router -> Edit -> Radius secret

mikrotik_router_radius

4) We cannot use more than one Radius server per Service

router_radius

Step 2. MikroTik PPP (in case when PPPoE is used)
1) Enable on Secrets -> PPP Authentication & Accounting features “Use radius (yes), Accounting (yes)”

ppp_authentication

2) Set Profile – default or default-encrypted, set Local address (it’s IP of Mikrotik router for establishing PPP connections)

ppp_local_address

Step 2. MikroTik DHCP
If we use IPoE authentication (DHCP), we should enable Radius communication on DHCP server.

radius_dhcp

Step 2. MikroTik Hotspot
For enabling Radius hotspot authentication, please, change the Hotspot configuration of Mikrotik under IP -> Hotspot as shown below:

radius_hotspot

When we enable services for Radius authentication, we can move forward and configure router in Splynx.

Step 3. Splynx router configuration
Splynx -> Networking -> Routers, here you can edit or change router settings. Important fields to fill are :
1) Radius Secret should be same as in Mikrotik settings
2) IP/Host –  the real IP (or host, or dyndns host) from which Mikrotik sends packets. In case when NAT is between Mikrotik and Splynx Radius, host IP will be public IP of NAT router and real IP will be private IP of Mikrotik router.
3) Authorization/Accounting – please set DHCP/PPP/HotSpot Radius. Even if you choose PPP, DHCP and Hotspot authentication will work as well. The difference is in DHCP Radius, here you can find accounting API. It means that for getting statistics from DHCP server, Splynx should connect to API of Mikrotik. This is caused by unsupported Radius accounting packets on Mikrotik routers.
4) NAS IP – IP address of router (on radius packet – NAS-IP-Address), in case when you use hostname of router you need to set this IP. (you can set this ip on Mikrotik  – Radius – Src. Address)

radius_settings

Step 4. Define IP networks for IP assignments
Splynx -> Networking -> IPv4 networks
1) Add some network for dynamic assignment (pool) or permanent (static) usage

networks

Step 5. Activate customer and set the Internet service
When we have added router and networks to Splynx, it’s the right time to add a customer and activate him

active

Then, we need to create an Internet service for the customer with PPP details (or MAC in case of DHCP authentication), IP address and other details.

service

If all these steps were made and still Mikrotik router shows Radius timeout in log, then, we need to make a quick troubleshooting.

Troubleshooting
First of all, check the file in Splynx logs called radius/short. It can be found in section Splynx -> Administration -> Logs -> Files. If this file is empty, Radius server should be set to debug mode.

Splynx Radius server consist of 2 daemons – splynx_radd and freeradius. Both of them have different debugging and show different information. Let’s start with splynx_radd debugging :

To enable debug mode of Splynx, connect via SSH to Splynx server and change the configuration file: /var/www/splynx/config/radius.php
[debug] section enable should be changed to – “true

To restart Radius server, enter command in SSH : service splynx_radd restart

Now we can check the debug file, again it’s accessible from CLI of Linux Splynx server:
/var/www/splynx/logs/radius/debug.log
The best way to check the file is command tail -f /var/www/splynx/logs/radius/debug.log

If splynx_radd debug doesn’t show us anything, we can try to run freeradius daemon in debug mode and see if any packets are received by Radius server.

Run CLI commands :
service freeradius stop
freeradius -Xxxx

and check the CLI console output.

If you don’t see any debug messages when customer tries to connect to Mikrotik Router, it means that your router cannot send packets and connect to Radius server at all. It means that you have to verify networking, routing and NAT settings of the network.

On Mikrotik Router there is also availability to run extended debug to see what exactly router is sending to Radius server :

debug_router

Splynx PayPal payments

You can receive payments via PayPal using Splynx. Splynx generates invoices for services, that are sent to customer’s email and to Splynx portal. From Splynx portal customer can pay the invoice using Paypal.

paypal

When customer clicks the PayPal button and applies to pay now, he is transferred to the PayPal page to make the payment.

paypal-copy

Customers can also add a credit card on PayPal payment webpage, if they don’t have a PayPal account.

add_card

 

After payment has made, the invoice is marked as paid, transaction in Splynx is created and customer’s balance is changed.

There are several steps needed to configure Splynx PayPal add-on:

1. Install the add-on with commands:

apt-get update

apt-get install splynx-paypal

2. Activate developer’s tool in your PayPal account.
Get the access to your business PayPal account on website https://developer.paypal.com

ClientID and ClientSecret are the values Splynx needs. Click on Add new Rest API application, call it Splynx.

2016-10-06-04-07-12-pm

Then, you can find ClientID and Secret on the page of application. Important is to choose “Live” version, because it shows values for test Sandbox account by default.

2016-10-06-04-10-15-pmWhen you got the ClientID and Secret, you can put it to Splynx server and connect Splynx with PayPal.

3. Configure Splynx to work with your PayPal account.
Connect to Splynx server via SSH and edit file params.php located at /var/www/splynx/addons/splynx-paypal/config.

‘splynx_url’ => ‘http://yoursplynxURL/’

‘clientId’ => ‘YOURPAYPALID’

‘clientSecret’ => ‘YOURPAYPALSECRET’

If you have any questions regarding PayPal integration, please, create a ticket and Splynx team will help you to set it up: https://splynx.com/my-tickets/

Prepaid billing in Splynx

In version 1.2 of our system we have added feature of full prepaid billing. It’s used when ISP charges customer in advance and provide him access for certain period of time. When balance of the customer reaches set limit, he is disconnected. Each customer has a type of billing – “Recurring payments” and “Prepaid”.

To set up hard prepay we need to change the billing type of the customer to Prepaid.

type_of_billing

 

 

 

 

 

 

 

 

 

 

 

Then we define what is the value of customer’s balance when Splynx will block his access to internet. By default it is set to “0”, but it can be changed in configuration of each customer in the field “Minimal balance”.

minimal_ballance

 

 

 

 

 

 

 

 

 

 

 

 

After setting up type “Prepaid”, we need to add a payment to customer’s account. For example, 20 USD has been added.

payment

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The deposit of the customer changed to 20 USD.

deposit

 

 

 

 

 

 

 

 

 

 

 

 

 

Let’s add a service of 5 Mbps for 40 USD/month. Splynx calculates the daily rate of the plan and charges user every day. There are 30 days in October, so daily rate is 1,33 USD. Tomorrow balance of the customer will be changed from 40 USD to 38,66 USD and will continue decreasing every day according to his plan.

services

 

In this particular situation, when customer has 20$ as a deposit, he will get access for 15 days. Then he reaches “0” on his balance and Splynx will block him.
If we check the deposit of the customer the next day, it will be reduced based on the daily fee:

prepay_balance
 

 

 

 

 

 

 

 

 

 

 

 

Also one transaction has been added, which shows how much we charged. This transaction is updated every day and it shows the total amount of money that has been taken from customer’s deposit.

prepay_transaction

If “Make invoices (after to charge)” is enabled, Splynx will generate an invoice for consumed services  on a first day of the next month.

You can find how to setup blocking in Splynx in other article:
https://splynx.com/2666/blocking-of-non-paying-customers/

Description of prepaid billing engine is available on video below:

 


Our engineers will always assist you in proper billing cycle configuration. Should you have any questions or further information is needed, please contact us or schedule a call with our engineer.