Sign up Login

XML Feed / Using Credits and setting the amount to bill a user via &value=

Follow

Q: I want to set the price to charge end-users using Credits (as opposed to using the Currency and Value), what 'value' should be in the request to your server?

 

A: With the 2010 release of our Gateway where you post messages to 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:

To use credits for the &value= you need to know 1) how much you want to bill the users, and 2) the available tariffs which you can bill in the country.

For example:

See http://xml.txtnation.com/xml and search for <country>DE</country>

For your other countries of operation, substitute the DE for the relevant country code, e.g.

China = CN = <country>CN</country>
UK = UK
USA = US
etc

(Tip: use Firefox if viewing in a web browser for easier viewing)

<id>MOBILCOM7DE4</id>
<name>Mobilcom</name>
<country>DE</country>
<shortcode>63000</shortcode>
<tariff>2.490 EUR</tariff>
<credits>4.250 Cr</credits>
<billing_type>IO</billing_type>
<keyword/>
<supportsWapPush>0</supportsWapPush>
<supportsVcards>0</supportsVcards>
<supportsUnicode>0</supportsUnicode>
<Default_Language>English</Default_Language>
<Monthly_User_Spending_Limit>-</Monthly_User_Spending_Limit>
<User_Transaction_Spending_Limit>-</User_Transaction_Spending_Limit>
<Require_Stop_Acknowledgment>0</Require_Stop_Acknowledgment>
<isAdult>0</isAdult>

You will see a number of different entries for <country>DE</country>. There are different amounts that you an bill there, so as above you need to decide how much you would like to bill, and find the available tariffs closest to that amount.

So for example if you want to bill 2.49 euros in Germany, set &value=4.250.

If you wanted to bill 4.49 euros, set &value=7.50

as per:

<id>VODAFONE7DE8</id>
<name>Vodafone</name>
<country>DE</country>
<shortcode>63000</shortcode>
<tariff>4.490 EUR</tariff>
<credits>7.500 Cr</credits>
<billing_type>IO</billing_type>
<keyword/>
<supportsWapPush>0</supportsWapPush>
<supportsVcards>0</supportsVcards>
<supportsUnicode>0</supportsUnicode>
<Default_Language>English</Default_Language>
<Monthly_User_Spending_Limit>-</Monthly_User_Spending_Limit>
<User_Transaction_Spending_Limit>-</User_Transaction_Spending_Limit>
<Require_Stop_Acknowledgment>0</Require_Stop_Acknowledgment>
<isAdult>0</isAdult>
</network>

 

Q. What happens if I post an amount that does not match the available lines on the XML feed? Is there a difference in the outcome when posting too high or too low?

 

  • MT Billed Countries
    • High - Our system will send additional messages to the user such as "Billing message". The message specified in your post will be the final one to be sent. If sending higher amounts it is recommended you increase in intervals of the available tariff.  
    • Low - If the amount you specified is less than our lowest tariff the amount billed will be the lowest tariff (Unless zero is specified).
  • MO Billed Countries
    • High - In the reply message our system will prompt the user to send another message until they have reached your desired amount.
    • Low - The user will be billed the tariff of the code regardless of a lower setting.

 

Let us know if you have any further questions.

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

Comments

Powered by Zendesk