Request Charging with TAC

Only for Mobile App API

This API call is only applicable to Service Providers with Mobile App API permission.

  1. Once the user receives their TAC, the user will key in the TAC in the mobile app and pass the TAC to the Service Provider server.

  2. The Service Provider server will need to invoke this API for charging requests.

  3. The Service Provider needs to display a success or failed page to the user/payer on the Mobile App.

Request

HTTP Method
POST
POST <AOC_SERVER>/api/chargeWithTAC
HTTP/1.1
Content type: application/x-www-form-urlencoded


{
  "aocTransID":"12345678",
  "apiKey":"Ofa3M7zS2c3",
  "username":"test",
  "msisdn":"+60191234567",
  "tac":"1234"
}

Request Parameter

Parameter NameDescriptionUsage
aocTransIDThis is the unique transaction id generated by AOC Gateway. This id is passed to the Service Provider during the getAOCToken API.(STRING) Mandatory
apiKeyThis will be API Key to access AOC. Will be provided by BOOSTCONNECT.(STRING)
Mandatory
usernameThis will be the username provided to the Service Provider by BOOSTCONNECT.(STRING) Mandatory
msisdnThe MSISDN of the subscriber. The user’s MSISDN includes the country code, e.g. 60191234567.(STRING) Mandatory
tacThe TAC key-in by the user.(STRING) Mandatory

Response

HTTP/1.1 200 OK 
Content-Type: application/json 
Content-Length: 12345 
Date: Tue, 01 Nov 2016 12:00:00 GMT


{ "data": 
{ 
  "transactionOperationStatus":"Charged", 
  "totalAmountCharged":"10.00", 
  "msisdn":"+60191234567", 
  "clientCorrelator":"12345678901234567", 
  "errorCode":"00", 
  "errorMessage":"" 
} 
}

Response Parameter

Parameter NameDescriptionUsage
transactionOperationStatusThe status of the charge transaction is as below:

1. Charged. (mean successfully charged).
2. Denied. (failed to charge. Check the error code list for reason).
3. Processing. (mean the charge is still under processing. Refer to section “Processing Status for Operator XL" for more details.)
(STRING)
totalAmountChargedThis is the actual amount being charged. It can be a whole number or a two-digit decimal.(DECIMAL)
msisdnThe MSISDN of the target user. The user’s MSISDN includes the country code preceded by '+', e.g. +60191234567.(STRING)
clientCorrelatorThis is the client correlator id that will be returned for all success charged transactions. Do keep this id as it will be used for reconciliation purposes.(STRING)
errorCodePlease check the error code list.(STRING)
errorMessageExplanation of the error.(STRING)