Request_ReloadSync
Partner send request to this method to initiate airtime recharge or send gift transaction. API will immediate process the request with the recipient mobile operator recharge system synchronously. Final transaction status will be responded within 100 seconds. In case of the transaction cannot be processed within 100 seconds, API will respond with status code 968 – Transaction Pending. Partner are required to query the final transaction status using method “Transaction_Enquiry”.
Request Parameters
No. | Parameter Name | Mandatory/ Optional | Parameter | Sample Parameter | Description |
1 | DealerTransactionId | M | String | 0a792511-5f1a-4705- 9381-b628992b1a2d | 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 | 1348990812912 | The sender mobile number in international dialing format (without the leading ‘+’ or ‘00’). |
3 | DestNo | M | String | 639129001213 | 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:- 3) Local currency of the Product. (the value of denomination will be in PHP if the recharge product is a Philippines’s product) 4) Currency of the partner e-wallet in Tranglo system. If e-wallet currency is in USD, partner can request a recharge 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 | e0ea4fc301155 2e6f799a447e7 2f9341 | 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_ReloadSync> 8 <tem:epinReq> 9 <tran:DealerTransactionId>0a792511-5f1a-4705-9381- 10 b628992b1a2d</tran:DealerTransactionId> 11 <tran:SourceNo>1348990812912</tran:SourceNo> 12 <tran:DestNo>639129001213</tran:DestNo> 13 <tran:OperatorCode>SM</tran:OperatorCode> 14 <tran:Denomination>500</tran:Denomination> 15 <tran:ByAmount>false</tran:ByAmount> 16 <tran:Credentials> 17 <tran1:UID>partner_api</tran1:UID> 18 <tran1:PWD>m8tA24bW</tran1:PWD> 19 <tran1:Signature>e0ea4fc3011552e6f799a447e72f9341</tran1:Signature> 20 </tran:Credentials> 21 </tem:epinReq> 22 </tem: Request_ReloadSync> 23 </soapenv:Body> 24 </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 transaction. |
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_ReloadSyncResponse 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_ReloadSyncResponse> 21 </s:Body> 22 </s:Envelope>