Product_Enquiry

This method will returns the operator code, supported product denomination and the price/forex rate based on a MSISDN. This method can help partner to determine a mobile number is belong to which mobile operator and its supported denomination list. Please take note that this method determine the mobile operator of the mobile number based on the default numbering plan only. If the mobile number has been ported out from its default mobile operator (MNP), this method is not able to return the new ported mobile operator.

Request Parameters

No.	Parameter Name	Mandatory/ Optional	Parameter Data Type	Sample Parameter Data	Description
1	Credentials.UID	M	String	partner_api	The API user ID that assigned to partner.
2	Credentials.PWD	M	String	m8tA24bW	The API password that assigned to partner.
3	Credentials.Signature	M	String	e0ea4fc301155 2e6f799a447e7 2f9341	The digital signature that hashed with MD5 algorithm. Please refer section “Appendix: Digital Signature Hashing Algorithm” to hashing reference.
4	DealerTransactionId	M	String	12345678	The unique transaction ID from partner system.
5	MSISDN	M	String	639129001213	The mobile number in international dialing format (without the leading ‘+’ or ‘00’).

Sample Request

1  <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
2   xmlns:tem="http://tempuri.org/" 
3   xmlns:tran="http://schemas.datacontract.org/2004/07/Tranglo20.Business.Processor" 
4   xmlns:tran1="http://schemas.datacontract.org/2004/07/Tranglo20.Common.Entity"> 
5   <soap:Header/> 
6   <soap:Body> 
7   <tem:Product_Enquiry> 
8   <tem:req> 
9   <tran:Credentials> 
10  <tran1:UID>partner_api </tran1:UID> 
11  <tran1:PWD>m8tA24bW</tran1:PWD> 
12  <tran1:Signature>e0ea4fc3011552e6f799a447e72f9341</tran1:Signature> 
13  </tran:Credentials> 
14  <tran:DealerTransactionId>1000</tran:DealerTransactionId> 
15  <tran:MSISDN>919820000000</tran:MSISDN> 
16  </tem:req> 
17  </tem:Product_Enquiry> 
18  </soap:Body> 
19 </soap:Envelope>

Response Parameters

No.	Parameter Name	Parameter Data Type	Sample Parameter Data	Description
1	Status.Code	String	000	The status code of the request.
2	Status.Description	String	Transaction is Successful	The description of the status code.
3	Status.Type	String	Approved	The category of the status code. There is 3 different Type – Approved, Error, and Pending.
4	ProductList.AmountStep	Decimal	10.00	The flexible denomination incremental step value. For eg: if the amount step = 10, it means the supported recharge denomination will be 10, 20, 30, 50 and so on. If flexible denomination is not supported, the response value will be 0.
5	ProductList.DenomType	Integer	1	The value will indicates the supported denomination is fixed denomination or flexible denomination. Value “1” mean Fixed denomination. Value “2” mean Flexible denomination.
6	ProductList.Denomination	Decimal	5000.00	The denomination value of the product. If the product is flexible denomination type, the value will be “0”.
7	ProductList.MinValue	Decimal	10.00	The minimum value of the flexible type denomination.
8	ProductList.MaxValue	Decimal	1000.00	The maximum value of the flexible type denomination.
9	ProductList.OperatorCode	String	IN_AT	The API product code that denote the mobile operator of the mobile number. This parameter can be sent to parameter “OperatorCode” for method Request_Reload.
10	ProductList.ProdCode	String	IN_AT_100	The code that represent the product.
11	ProductList.ProdCountry	String	India	The country of the product.
12	ProductList.ProdSellPrice	Decimal	17.78	The product price for fixed denomination product or the forex rate for flexible denomination product.

Sample Response

1   <s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" 
2    xmlns:a="http://www.w3.org/2005/08/addressing"> 
3    <s:Header> 
4    <a:Actions:mustUnderstand="1">
5    http://tempuri.org/IGloTransfer/Product_EnquiryResponse</a:Action> 
6    </s:Header> 
7    <s:Body> 
8      <Product_EnquiryResponse xmlns="http://tempuri.org/"> <Product_EnquiryResult 
9      xmlns:b="http://schemas.datacontract.org/2004/07/Tranglo20.Business.Processor" 
10      xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> 
11       <b:Status xmlns:c="
12       http://schemas.datacontract.org/2004/07/Tranglo20.Common.Entity">   
13       <c:Code>000</c:Code> 
14       <c:Description>Transaction is Successful</c:Description>
15       <c:Type>Approved</c:Type> 
16       </b:Status> 
17       <b:ProductList> 
18        <b:ProductEntity1> 
19        <b:AmountStep>0</b:AmountStep> 
20        <b:DenomType>1</b:DenomType> 
21        <b:Denomination>100</b:Denomination> 
22        <b:MaxValue>100</b:MaxValue> 
23        <b:MinValue>100</b:MinValue> 
24        <b:OperatorCode>IN_AT</b:OperatorCode> 
25        <b:ProdCode>IN_AT_100</b:ProdCode> 
26        <b:ProdCountry>India</b:ProdCountry> 
27        <b:ProdSellPrice>4.58</b:ProdSellPrice> 
28        </b:ProductEntity1> 
29        <b:ProductEntity1> 
30        <b:AmountStep>1</b:AmountStep> 
31        <b:DenomType>2</b:DenomType> 
32        <b:Denomination>0</b:Denomination> 
33        <b:MaxValue>10</b:MaxValue> 
34        <b:MinValue>1000</b:MinValue> 
35        <b:OperatorCode>IN_AT</b:OperatorCode> 
36        <b:ProdCode>IN_AT_10_1000</b:ProdCode> 
37        <b:ProdCountry>India</b:ProdCountry> 
38        <b:ProdSellPrice>66.44</b:ProdSellPrice> 
39        </b:ProductEntity1> 
40       </b:ProductList> 
41      </Product_EnquiryResult>
42     </Product_EnquiryResponse> 
43    </s:Body> 
44   </s:Envelope>