BILLmanager allows you to authenticate system users via phone number using SMS messages. To do this, the billing platform must be integrated with the SMS service.

Creating a new gateway

To start the Add New Gateway Wizard, enter Integration → Phone verification gateways → Add button. It consists of two steps: Creating a gateway and Gateway settings.

Creating a gateway

Choose a suitable SMS service:

  • SMS-center (call);
  • TeleSign;
  • Clickatell;
  • Devino Telecom;
  • GREENSMS;
  • MobilMoney;
  • QuickTelecom;
  • SMS-center;
  • http-SMS;
  • SMS Traffic;
  • TurboSMS.

If the required service is missing, you can use the universal http-SMS gateway.

Gateway parameters

Fill in the data for integration with the messaging service:

  • Name — the name of the gateway in BILLmanager;
  • Provider — select the provider for which this gateway will be used. Leave the field blank so that the gateway is used for all providers;
  • Priority — the priority by which the gateways are sorted when the client verifies the phone number. The bigger number has the higher priority;
  • Timeout (minutes) — waiting period before sending the code again;
  • Code validity period (minutes) — the period after which the code will be considered invalid;
  • Activate after creation — activate the option to enable the gateway after creation;
  • Message text — message text for users of the specified localization;
  • Specify the data for authentication in the messaging service.

Example of setup

Universal gateway

The form of the universal gateway configuration is different, because the provider needs to specify data to connect to the service via API:

Macros must be used in the API request template:

  • {phone} — phone number;
  • {message} — message text generated from an EJS template;
  • {sender} — sender's signature. The value from the Sender field is used.

All the necessary information for connecting to the SMS service via API can be found at the service provider's website. 

Logging

The logs of connected gateway modules are stored in /usr/local/mgr5/var and are named gw<name of service>.log or fg<name of gateway>.log:

  • var/fgsmsc.log
  • var/fgsmsgate.log
  • var/fgtelesign.log
  • var/gwclickatell.log
  • var/gwdevinotele.log
  • var/gwgreensms.log
  • var/gwmobilmoney.log
  • var/gwqtelecom.log
  • var/gwsmsc.log
  • var/gwsmscustom.log
  • var/gwsmstraffic.log
  • var/gwturbosms.log

Universal gateway

Universal module log file: /usr/local/mgr5/var/gwsmscustom.log.