Sign up Login

XML Feed / Version 2 Explained

Follow

The feed is located at networks.xml

Below is a sample network extract from the XML feed:

<network>
<id>ORANGEUK</id>
<name>Orange</name>
<country>UK</country>
<country_name>United Kingdom</country_name>
<shortcode>60999</shortcode>
<currency>GBP</currency>
<price_point>
<tariff>0.250</tariff>
<credits>0.500</credits>
</price_point>
<price_point>
<tariff>0.500</tariff>
<credits>1.000</credits>
</price_point>
<price_point>
<tariff>1.000</tariff>
<credits>2.000</credits>
</price_point>
<price_point>
<tariff>1.500</tariff>
<credits>3.000</credits>
</price_point>
<price_point>
<tariff>3.000</tariff>
<credits>6.000</credits>
</price_point>
<price_point>
<tariff>5.000</tariff>
<credits>10.000</credits>
</price_point>
<price_point>
<tariff>10.000</tariff>
<credits>20.000</credits>
</price_point>
<billing_type>MT</billing_type>
<keyword/>
<capabilities>
<reports>YES</reports>
<adult_content_allowed>NO</adult_content_allowed>
<supports_wap_push>NO</supports_wap_push>
<supports_vcards>NO</supports_vcards>
<supports_unicode>NO</supports_unicode>
<supports_direct_operator_billing>NO</supports_direct_operator_billing>
</capabilities>
<default_language>English</default_language>
<require_stop_acknowledgment>NO</require_stop_acknowledgment>
<imsi>
<mnc>33</mnc>
<mcc>234</mcc>
</imsi>
</network>

 

As you can see this differs from version 1. You can see all of the variables are the same but we have now removed the number at the end of each network entry and linked them into one entry covering allavailible tariff on the particular shortcode. 

Please see below for further details on important variables:

<id>ORANGEUK5</id>

This is the mobile network ID, you will notice some networks have numbers appended to the end like above. This is to distinguish between multiple tariffs on the same short code and should be removed before posting to us. In the example you should use "ORANGEUK" removing the "5". When you receive a post this number will not be present.

To quickly search the XML feed and hit CTRL + F on your keyboard (command + F) on a mac. Enter the countries two letter code between > + < (i.e, >IL< for Israel) in the text box. This will then search the entire page for you.

For a full list of all countries please follow this link http://www.iso.org/iso/country_codes.htm

<tariff>0.250 GBP</tariff>

This is the value of the network entry in local currency, translated it would be sent as: "value=0.25", "currency=gbp"

<credits>0.500</credits>

For clients using our older version of the mobile gateway this is the credit value associated with each tariff, if you are reading this it is likely you can ignore this value.

With the 2010 release of our Gateway where you post messages to http://client.txtnation.com/gateway.php or http://client.txtnation.com/mbill.php (as opposed to the old http://client.txtnation.com/ir_response.php) you can post in local currency and value, which is easier than the below Credits http post method:

Credits - txtNation uses a simple credit notation as the charging unit for microbilling. 1 Credit = 0.5 GBP. Values for other currencies will be converted at the given exchange rate. A client sets the value of a billed SMS message to a number of credits, rather than having to set a value for each currency.

1 Credit = 0.5 GBP. 
0.5 Credit = 0.25 GBP

Please Note: Values for other currencies will be converted at the given exchange rate.

Note that, although campaigns are set up in Credits, rather than units of currency, your advertising must show your customers how much they will pay in their currency.

Check to see what each line bills, and when you are performing your post to us, set the amount of credits that corresponds to the value of the line / the amount you want to bill.

<billing_type>MT</billing_type>

This is the billing type of the shortcode, for more information on this please read: http://clients.txtnation.com/entries/163712-all-products-premium-sms-what-are-the-sms-billing-types-available-what-are-mt-mo-no-do-io-mf-lc-dc

<country_prefix/>

If a value is present in this field it should be placed for your keyword upon texting in (unless otherwise pre-arranged with your account manager).

We have also changed:

 

<reports>2</reports>

<supportsWapPush>0</supportsWapPush>

<supportsVcards>0</supportsVcards>
<supportsUnicode>0</supportsUnicode>

<Require_Stop_Acknowledgment>0</Require_Stop_Acknowledgment>

<isAdult>0</isAdult>

To a simple Yes or no option to make this easier to understand.

Was this article helpful?
0 out of 0 found this helpful

Comments

Powered by Zendesk