Free Minutes documentation

[EtienneBruines]

It would be nice, if the 'Free Minutes' had some kind of documentation.

What I figured out:

You can create a new Service Type, for example '60 free minutes in Germany', by creating a Service Type with the provisioning class Billing::Provisioning::FreeMinutes and variables

    {
		"prefixes": [
			{
				"prefix": "49",
				"duration": 3600,
				"exclude": false
			}
		]
	}

(Although for the duration I'm not sure whether it's minutes or seconds...)

If I wanted only landlines, I'd add ignore_prefixes with values ["4915", "4916", "4917"] or something to exclude mobile numbers.

I could not find any documentation on this, so this is just guesswork based on this source code.

What is still unclear

Let's say I wanted to allow '60 free minutes in Europe' - for simplicity sake we can say Europe only contains prefixes 49 and 39, but that counter has to be shared. I don't want to allow 45 minutes to Germany and 45 minutes to Switzerland, but for those prefixes to share the 60 minutes.

I cannot create an empty prefix (and then include all 'incorrect' ones), but I also cannot create a single package counter that counts multiple prefixes. Am I correct, that this is not possible?

What the exclude flag means, I do not know. And what meaning it has when an excluded prefix has a duration, I do not know.

/cc @senid231

[dmitry-sinina]

• duration in seconds
• you figured out it correctly.
• Looks like for this case it is not possible to create shared counter because your call destination not under same prefix, and it is not possible currently create empty prefix.

Proper solution:

• allow empty prefix in billing package(require development)
• enable allow_package_billing only on destinations related to Europe.(ignore_prefixes also ok, but I think it will be easier to manage it in destinations)