AddingTopup

There could be several ways to call different XML APIs to add the balance on customer's account. This is just one of those flows/methods which is mentioned here.

In order to add the balance on the customer's account first thing which you will need to know is the denomination /topup values which are allowed to be added on the account to get that list you call GetDenomination XML API. Below are the required fields in the GetDenomination XML API

<COMPANYID>28</COMPANYID> <STATE>OK</STATE>

Above mentioned fields can be obtained using the the GetCustomerInfo XML API

After you call the GetDenomination XML API you will have a list of the denomination /topup values which can be added on the customer's account. After you select the topu up value which needs to be added you will also need to know the tax to be charged for that you call GetTaxDetail XML API

Finally when you have the total amount to be charged you have two options:

  1. . Call the Payment XML API followed by AddBalance API or
  2. Call AddBalancewithPayment Below is the sample request for AddBalancewithPayment. You get the CUSTOMERID and CARRIER CODE from GetCustomerInfo

Upon the success response the topup amout is applied to the customer's account.

<CUSTOMERID>2345665</CUSTOMERID> <CARRIERCODE>1315</CARRIERCODE> <COMPANYID>28</COMPANYID> <TAXREQUIRED>Y</TAXREQUIRED> <TOTALPAYMENT>35.00</TOTALPAYMENT> <CARDTYPE>VISA</CARDTYPE> <CARDVALUE>4111111111111111</CARDVALUE> <CARDCODE>232</CARDCODE> <EXPIRATION_MONTH>12</EXPIRATION_MONTH> <EXPIRATION_YEAR>2018</EXPIRATION_YEAR> <NAMEONCARD>John Doe</NAMEONCARD> <BILLINGSTATE>CA</BILLINGSTATE> <BILLINGADDRESS>123 Main St</BILLINGADDRESS> <BILLINGADDRESS2>Apt 1</BILLINGADDRESS2> <BILLINGCITY>San Jose</BILLINGCITY> <BILLINGZIPCODE>90001</BILLINGZIPCODE> <BALANCETYPE>TOPUP</BALANCETYPE> <AUTOPAYSTATUS>N</AUTOPAYSTATUS> <MINUTEBALANCE></MINUTEBALANCE> <DATABALANCE></DATABALANCE> <AMOUNTPLANCODE></AMOUNTPLANCODE>