Detailed documentation for sections covered in this tutorial can be found at:

• Pricing
• Pricing Changes and Distribution
• Services
• Account balances

A pricing plan (rate sheet) is the set of prices your customers pay. A service combines one pricing plan with one routing profile. Customer SMPP accounts use a service, so they inherit that plan.

Prices are used for:

• deducting a monetary account balance
• reporting, CDRs and Status > Message lookup
• invoices

Effective and cease date/times are shown in the local time zone of the web browser.

Pricing plans

Pricing plans are defined in Configuration > Pricing. The prices inside each plan are managed in Pricing and Pricing > Plan prices.

Add a pricing plan

1. Go to Configuration > Pricing.
2. Click Add pricing plan.
3. Enter a name (customers may see this name on published rate sheets).
4. Choose the plan Type: Country or Network (see below).
5. Set the plan currency if prompted.
6. Click Save.

The plan now appears on the Pricing dashboard with columns for the services that use it, type, notice period, currency and whether it is published publicly.

Row actions on the dashboard:

• PDF / CSV — download the current rate sheet
• Email — send the current pricing (preview to yourself, or to customers on services that use the plan)
• JSON — open the public pricing URL (when public publish is enabled)

Attach the plan to a service

1. Go to Configuration > Services.
2. Create or edit a service.
3. Select the pricing plan and a routing profile.
4. Click Save.

Country vs network pricing plans

For a country plan, add price items with the country selected and the network left undefined.

For a network plan, add price items with both country and network. Also add a row for the country default network so unknown networks still have a price.

If a customer has a monetary balance and no price can be found for the destination, the submit is rejected and no message ID is issued.

The customer's balance currency does not have to match every price currency. When they differ, the current exchange rate is used for the deduction.

Download / upload pricing

Download

On the Pricing dashboard, click CSV or PDF for the plan.

Alternatively, in Pricing > Plan prices click Download, select the plan, and choose CSV or PDF.

CSV export uses:

Country,Prefix,Network,MNC,Currency,Price,Type,Effective

Type is S (submit — charged regardless of delivery) or D (delivered — charged only when delivered).

Example:

Country,Prefix,Network,MNC,Currency,Price,Type,Effective
Belgium,32,All,,EUR,0.05520,S,2022-12-15T23:20:00+00:00
Ireland,353,All,,GBP,0.03600,D,2021-10-05T23:00:00+00:00

Upload

In Pricing > Plan prices, click Upload to open the Import Customer Pricing wizard.

Select the pricing plan and the CSV file.

Importing will close (cease) existing prices for the destinations that are being imported.

Two import layouts are supported:

Format A — MCCMNC,Price,Currency,Effective (treated as submit prices)

23410,0.016,GBP,2021-01-01T00:00:00+00:00

Format B — the same columns as the download (Country,Prefix,Network,MNC,Currency,Price,Type,Effective)

If MNC contains only an MCC, the row is a country default. If MNC is blank, the country is taken from Prefix (and Country if needed).

Supported currencies include USD, GBP, EUR, CHF, NZD, AUD, JPY, ZAR, CAD, HKD, SGD, MXN, INR, BRL and others.

Changing prices

There are two ways to change prices. Choose based on whether customers should be notified.

Change a single price (no notification)

1. Go to Pricing > Plan prices.
2. Find the destination.
3. Click Change price.
4. Enter the new price, charge basis (submit vs delivered) and effective date/time.
5. Click Save.

No customer notification is generated.

To add a destination that is not yet in the plan, click Add price item, select the plan, country and (for network plans) network, set price, currency, charge basis and effective date/time, then Save.

Batch changes with notification

Use Pricing > Pricing changes when you want a review step and customer emails.

1. Go to Pricing > Pricing changes.
2. Select the pricing plan.
3. Click Create manual change.
4. Click Add price change for each destination and enter the new price.
5. When the batch is complete, click Approve.
6. Confirm. The prices are applied and notification emails are queued.

Queued emails appear in Customers > Notifications. Click Send notifications to send them. Each send is recorded on the customer's Notes tab.

See Pricing Changes and Distribution for screenshots of this workflow.

Email notifications

Emails use templates in Configuration > Company > Email templates:

• Pricing: Current pricing — sending the current rate sheet
• Pricing: Notification of pricing change — announcing a change

Templates inherit the logo, signature and sender address from Configuration > Company. Customise the wording there before you send to customers.

Send current pricing

On the Pricing dashboard, click Email for the plan.

You can send a preview to yourself first, then send to all customers whose services use that plan.

The same action is available after you have edited prices directly in Pricing > Plan prices.

Send change notifications

After approving a batch in Pricing > Pricing changes:

1. Go to Customers > Notifications.
2. Select the batch.
3. Click Send notifications.

If you only changed prices with Change price and still need to tell customers, use Email on the Pricing dashboard (current pricing template) rather than the change-notification batch.

Troubleshooting

If the issue remains, contact Support.