Help Center
All seller guides

Getting started

Buyers and quality

SMS

Phone numbers and eSIMs

Money

Tools

Reports and settings

Add your first route to sell

Guide 2 of 147-minute readUpdated 21 October 2026

In short: Go to Routes → My Routes, click Add New Route, choose VOICE (SIP) or SMS (SMPP), fill in the name, IP Address:Port, capacity and route type, and click Add Route. The route starts with an empty tariff, so upload your rates next. Edit Route holds number translation, OBR, caller ID policy and your subscribed buyers.

How buyer traffic reaches your route
  1. Market ViewBuyers find and purchase your route
  2. then, Purchase, Buyer's switchDials your Buyers Prefix before the number
  3. then, 80039#18661234567, TelecomsXchangeSelects your route, applies number translation
  4. then, 18661234567, Your switchYour IP Address:Port, without the prefix
On this page
  1. How do I add a route?
  2. What is the Buyers Prefix?
  3. How do I change a route's settings?
  4. How do I allow or block caller IDs on a route?
  5. How do I stop selling a route?
  6. What if something goes wrong?
  7. Common questions

A route (also called a connection) is a path for traffic into your network, with its own prices, capacity and quality rules. Buyers find it in Market View, buy it, and send traffic that TelecomsXchange delivers to your IP address.

How do I add a route?#

  1. Go to Routes → My Routes. You'll see your routes with their publicity, protocol, IP address, capacity and type, Buyers Prefix, status and, for SMS routes, Bind Status.
The Routes page listing each route's publicity, protocol, IP address, Buyers Prefix and status
  1. Click Add New Route.
  2. Under Protocol, choose VOICE (SIP) or SMS (SMPP).
  3. Fill in the route fields (see the table below).
  4. Click Add Route.
The Add New Route form with Protocol, Name, IP Address:Port, Publicity, capacity and Route Type

You'll see "Route has been added. Proceed to the route list or add more." The route starts with an empty tariff, so it won't sell until you upload your rate deck.

These are the fields on the Add New Route form:

Field What to enter
Name A short name buyers will see, for example Platinum. It must be different from your other routes' names.
IP Address:Port Where TelecomsXchange sends traffic, for example 203.0.113.10:5060
Secondary IP Address:Port Optional failover endpoint. It must be different from the primary.
Publicity Public, or Anonymous to hide your company name (monthly fee). You can't change this later.
VoIP Login (optional) / VoIP Password (optional) Credentials, if your switch needs them. If you set a login, you must set a password too. Don't use : or ;.
Route Capacity The maximum number of simultaneous calls, as a number
Route Type (QoS) NA, NoCLI, TDM or CLI. Choose the type that matches your route; buyers rely on it.

For an SMS (SMPP) route, the form changes:

Field What to enter
SMPP System Id / SMPP Password Both are required. The system ID can't be one another seller already uses.
SMPP Sessions Number of sessions, from 1 to 100
SMPP Session Timeout Seconds, from 1 to 300
Field for Messages short_message or message_payload
SMPP Enquire Link Interval (0 = disable) Seconds, from 10 to 600, and less than the session timeout. Use 0 to turn it off.

The rest of an SMS route's settings (SMPP version, bind sessions, rate limit, keep-alive, TLS, the MCCMNC tariff and Test Bind) live on Edit Route. See Sell SMS routes.

Warning

An Anonymous route is charged the monthly fee from your balance as soon as you add it. The form shows the amount. If your balance is too low, the route isn't added.

What is the Buyers Prefix?#

TelecomsXchange generates a unique Buyers Prefix for every route: 5 digits followed by #, for example 80039#. Buyers put it in front of the number they dial to select your route. You can't change it.

Calls reach you without the prefix. TelecomsXchange sends numbers in international format, for example 18661234567.

How do I change a route's settings?#

  1. In Routes → My Routes, open the route's action menu and click Edit Route.
The Edit Route page with Required Settings, Upload Tariff and number translation
  1. Change the settings you need (see the list below).
  2. Click Update Settings.

You'll see "Route information updated successfully." These are the settings on the Edit Route page:

  • Required Settings: Route Name, IP addresses, credentials, Route Capacity, Route Type, and the Buyers Prefix (read only).
  • OBR Enabled (voice routes): switch on origin-based (OBR) handling, which matches the caller's number against your prefixes. With it on, choose OBR Prefix Match (Exact Prefix Match Only, or Fallback to parent prefixes for match to try shorter prefixes when there's no exact match) and OBR Source Match (Match Only P-Asserted-Identity, or Fallback to From to use the From header when there's no P-Asserted-Identity). The route then takes a second, origin-based tariff under Upload OBR Tariff; see Upload your rate deck.
  • Blocked and Private Exchange switches. With Private Exchange on, only the buyers you allow can buy the route. See Manage your buyers and make private offers. On an anonymous route, Blocked also controls the monthly fee ("Block/unblock to control anonymous billing"), and Anonymous Billed To shows the date the route is paid up to.
  • Upload Tariff: Download current rates (CSV), then upload your edited file. Upload Tariff Help at the top of the page explains each column. See Upload your rate deck.
  • Short Memo for Buyers: a short note displayed in Market View. The form suggests 150 characters.
  • Outgoing Number Translation Parameters (voice): Strip First X Digits, Strip Prefixes (a comma-separated list such as 31,7,44) and Outgoing Prefix (digits, + or #, up to 15 characters), to match your switch's dialing format.
  • CLI Management (voice; shown only when TelecomsXchange has enabled it for your account): CLI Method Pass-Through (keep the original caller ID), Empty (clear it), Random (generate one from CLI Prefix and CLI Total Length) or Dictionary (use caller IDs from a list you upload). Upload Dictionary takes a CSV with a header row and two columns, an action (A to add, D to delete) and the CLI; click Download to get the current dictionary.
  • Minimum Traffic Requirements (voice): Block if ASR Goes Lower Than (%), Block if ACD Goes Lower Than (sec) and Traffic Type (Retail or No Restriction). Compliance is calculated on daily traffic. See quality thresholds.
  • Subscribed Buyers: who uses the route, with Daily ASR, Daily ACD and Daily Minutes, and Block or Unblock for each buyer. Blocking sends the buyer an inbox message.
  • Block/Allow Caller IDs (CLID) Policy (voice): see below.

How do I allow or block caller IDs on a route?#

At the bottom of Edit Route on a voice route, Block/Allow Caller IDs (CLID) Policy holds a list of caller ID prefixes and a policy that says what the list means.

  1. Check Current Policy: Deny listed (Allow all others) or Allow listed (Deny all others). Click Switch to Allow List or Switch to Deny List to change it.
  2. Under Add CLI Prefix, type a numeric prefix, or EMPTY to match calls with no caller ID, and click Add.

The prefix appears in the table with its Add Date. Click Remove to delete it. Prefixes must be digits only; a prefix that's already in the list gives "Duplicate prefix detected."

How do I stop selling a route?#

  1. Go to Routes → My Routes.
  2. Open the route's action menu and click Block Route.

The route's status changes to Blocked. To sell it again, click Unblock Route in the same menu. Blocked routes are hidden from the list until you click Show Blocked Routes; click Hide Blocked Routes to hide them again.

Tip

In the list, an anonymous route shows ✓ Billed or ⚠ Unbilled under its publicity, an SMS route with TLS shows a lock icon, and the Bind Status icon of an SMS route opens its bind log.

Web users with the Finance role can't open My Routes or Edit Route.

What if something goes wrong?#

You see What to do
IP should be either IP address, say 1.2.3.4 or host:port like 1.2.3.4:5060 Enter an IP such as 203.0.113.10 or an IP and port such as 203.0.113.10:5060.
Secondary IP should be either IP address, say 1.2.3.4 or host:port like 1.2.3.4:5060 Fix the Secondary IP Address:Port the same way, or leave it empty.
IP:port is not unique / Secondary IP:port is not unique Another seller's route already uses that destination. Use a different IP or port.
Same Primary and Secondary hostport are not allowed Use a different secondary, or leave it empty.
DNS names only allowed with VoIP Login or Tech prefix Use an IP address, set a VoIP Login and password, or (on Edit Route) set an Outgoing Prefix.
'Route Capacity' parameter must be a number Enter digits only.
VoIP password should not be empty when VoIP login is set Enter both a login and a password, or neither.
Name is not available, choose another name You already have a route with that name. Pick another.
Not enough balance to pay for anonymous monthly fee Add to your balance, or choose Public.
'Strip first X digits' parameter expects integer Enter a whole number in Strip First X Digits, or 0.
'Strip prefixes' parameter expects comma separated list of integers, for example '1,1800,1866' Use digits and commas only in Strip Prefixes.
'Add Prefix' parameter expects integer or + or # sign Use only digits, + and # in Outgoing Prefix, up to 15 characters.
'Block ASR' / 'Block ACD' parameter expects numeric value Enter numbers only, or leave the field empty.
OBR Prefix Match can be only … Pick one of the options in OBR Prefix Match and OBR Source Match and save again.
SMPP system id and password should not be empty Enter both the SMPP System Id and the SMPP Password.
SMPP system id is not unique Use a different SMPP System Id.
Allowed SMPP Sessions expected values are between 1 and 100 Enter a number of SMPP Sessions from 1 to 100.
SMPP Session Timeout value should be between 1 and 300 Enter a timeout from 1 to 300 seconds.
SMPP Session Enquire Link value should be between 10 and 600 (0 to disable) Enter an interval from 10 to 600 seconds, or 0.
SMPP Session Enquire Link value should be less than SMPP Session Timeout Make the enquire link interval shorter than the session timeout.

Common questions

Can I set my own tech prefix?

No. TelecomsXchange generates a unique Buyers Prefix, such as 80039#, for every route. Calls reach you without it; you can add your own prefix with Outgoing Prefix in Edit Route.

What's the difference between Public and Anonymous?

A Public route shows your company name in Market View; an Anonymous route hides it. An Anonymous route costs a monthly fee, shown on the Add New Route form and taken from your balance. You can't switch a route between Public and Anonymous after you add it.

Can I use a hostname instead of an IP?

On a voice route, only if you also set a VoIP Login (on Edit Route, an Outgoing Prefix also counts). Hostnames ending in restcomm.com are always accepted, and SMS routes have no restriction. Otherwise use an IP address such as 203.0.113.10 or an IP and port such as 203.0.113.10:5060.

How do I stop selling a route temporarily?

In Routes → My Routes, open the route's action menu and click Block Route. Click Unblock Route in the same menu to sell it again.

Can I offer a route to only some buyers?

Yes. Turn on Private Exchange in Edit Route, save, and allow the buyers you choose. See Manage your buyers and make private offers.

Where are the SMPP bind settings?

On the Edit Route page of an SMS route: SMPP version, bind sessions, rate limit, keep-alive and TLS. The Routes list shows each SMS route's Bind Status, and the action menu has Test Bind. See Sell SMS routes.

Can I set my own tech prefix?
No. TelecomsXchange generates a unique Buyers Prefix, such as 80039#, for every route. Calls reach you without it; you can add your own prefix with Outgoing Prefix in Edit Route.
What's the difference between Public and Anonymous?
A Public route shows your company name in Market View; an Anonymous route hides it. An Anonymous route costs a monthly fee, shown on the Add New Route form and taken from your balance. You can't switch a route between Public and Anonymous after you add it.
Can I use a hostname instead of an IP?
On a voice route, only if you also set a VoIP Login (on Edit Route, an Outgoing Prefix also counts). Hostnames ending in restcomm.com are always accepted, and SMS routes have no restriction. Otherwise use an IP address such as 203.0.113.10 or an IP and port such as 203.0.113.10:5060.
How do I stop selling a route temporarily?
In Routes → My Routes, open the route's action menu and click Block Route. Click Unblock Route in the same menu to sell it again.
Can I offer a route to only some buyers?
Yes. Turn on Private Exchange in Edit Route, save, and allow the buyers you choose. See Manage your buyers and make private offers.
Where are the SMPP bind settings?
On the Edit Route page of an SMS route: SMPP version, bind sessions, rate limit, keep-alive and TLS. The Routes list shows each SMS route's Bind Status, and the action menu has Test Bind. See Sell SMS routes.

Related guides

This guide matches platform build 83b4ebc9. Markdown version.