Request_Reload

Partner send request to this method to initiate airtime recharge or send gift transaction. When the request is accepted, system will respond with status code 001 and it means the transaction is accepted. Status code 968 is not the final status code yet. Once the transaction is processed by receiving partner, System will send the final status code of the transaction to an URL hosted on partner system. Partner can also query the transaction status using method “Transaction_Enquiry”.

Request Parameters

No.	Parameter Name	Mandatory/ Optional	Parameter Data Type	Sample Parameter Data	Description
1	DealerTransactionId	M	String	0a792511- 5f1a-4705-9381b6289 92b1a2d	The unique transaction ID from partner system. It will be used by partner to identify the submitted transaction
2	SourceNo	O (Please put zero if not available)	String	134899081 2912	The sender mobile number in international dialing format (without the leading ‘+’ or ‘00’).
3	DestNo	M	String	639129001 213	The receiver mobile number in international dialing format (without the leading ‘+’ or ‘00’).
4	OperatorCode	O	String	SM	The API product code for the product that partner want to recharge using this API. Can leave blank and API will automatically detect the right OperatorCode for you.
5	Denomination	M	Decimal	500	The product’s recharge amount/denomination. API can accept the recharge amount in the 2 different currency as:- 1) Local currency of the Product. (the value of denomination will be in PHP if the recharge product is a Philippines’s product) 2) Currency of the partner e-wallet in Tranglo system. If e-wallet currency is in USD, partner can request are charge amount in USD value. System will automatically convert the USD amount into equivalent recharge denomination in local currency of the product. Note: If partner want to send the denomination in the currency of e-wallet, please set “True” for the parameter “ByAmount” below.
6	ByAmount	O	Boolean	False	Please set to “True” if want to send the denomination in the price of e- wallet currency, eg: USD 2.50.
7	Credentials.UID	M	String	partner_api	The API user ID that assigned to partner.
8	Credentials.PWD	M	String	m8tA24bW	The API password that assigned to partner.
9	Credentials.Signature	M	String	e0ea4fc301 1552e6f799a 447e72f9341	The digital signature that hashed with MD5 algorithm. Please refer section “Appendix: Digital Signature Hashing Algorithm” to hashing reference.

Sample Request

1  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/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   <soapenv:Header/> 
6   <soapenv:Body> 
7    <tem:Request_Reload> 
8     <tem:epinReq> 
9      <tran:DealerTransactionId>0a792511-5f1a-4705-9381-
        b628992b1a2d</tran:DealerTransactionId> 
10     <tran:SourceNo>1348990812912</tran:SourceNo> 
11     <tran:DestNo>639129001213</tran:DestNo> 
12     <tran:OperatorCode>SM</tran:OperatorCode> 
13     <tran:Denomination>500</tran: Denomination> 
14     <tran:ByAmount>false</tran:ByAmount> 
15     <tran:Credentials> 
16      <tran1:UID>partner_api</tran1:UID> 
17      <tran1:PWD>m8tA24bW</tran1:PWD> 
18      <tran1:Signature>e0ea4fc3011552e6f799a447e72f9341</tran1:Signature>  
19     </tran:Credentials> 
20    </tem:epinReq> 
21   </tem:Request_Reload> 
22  </soapenv:Body> 
23 </soapenv:Envelope>

Response Parameters

No.	Parameter Name	Parameter Data Type	Sample Parameter Data	Description
1	Status.Code	String	968	The status code of the submitted
2	Status.Description	String	Transaction Pending	The description of the status code.
3	Status.Type	String	Pending	The category of the status code. There is 3 different Type – Approved, Error, and Pending.
4	WalletCurrency	String	USD	ISO 4217 Currency code of the partner’s e-wallet currency in Tranglo system.
5	ProductPrice	Decimal	2.50	The price of the requested product that Tranglo deducted from partner’s e-wallet.
6	AmountCurrency	String	PHP	The currency of the requested product.
7	AmountAfterTax	Decimal	500	Recharge amount received on recipient number after local tax deduction (if any)
8	TrangloTransactionID	String	1234567890	Unique Transaction ID generated by Tranglo system.
10	OperatorCode	String	SM	The API product code.
11	Denomination	Decimal	500	The product’s recharge amount/denomination.
12	OperatorTransactionID	String	R332533770	Transaction reference number that generated by the mobile operator or recipient biller system.

Sample Response

1  <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> 
2   <s:Body> 
3    <Request_ReloadResponse xmlns="http://tempuri.org/"> <Request_ReloadResult 
4     xmlns:a="http://schemas.datacontract.org/2004/07/Tranglo20.Business.Processor"
5     xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> 
6     <a:Status 
      xmlns:b="http://schemas.datacontract.org/2004/07/Tranglo20.Common.Entity">   
7      <b:Code>968</b:Code> 
8      <b:Description>Transaction Pending </b:Description> 
9      <b:Type>Pending</b:Type> 
10     </a:Status> 
11      <a:WalletCurrency>USD</ a:WalletCurrency> 
12      <a:ProductPrice>0</a:ProductPrice>   
13      <a:AmountCurrency>PHP</ a:AmountCurrency> 
14      <a:AmountAfterTax>500</a:AmountAfterTax>  
15      <a:TrangloTransactionId>1234567890</a:TrangloTransactionId>  
16      <a:OperatorCode>SM</a:OperatorCode> 
17      <a:Denomination>500</a:Denomination> 
18      <a:OperatorTransactionID>R332533770</ a:OperatorTransactionID> 
19     </Request_ReloadResult> 
20    </Request_ReloadResponse> 
21   </s:Body> 
22  </s:Envelope>