Request Charging with TAC
Only for Mobile APP API
This API call is only applicable for Service Provider with Mobile App API permission.
-
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.
-
Service Provider server will need to invoke this API for charging requests.
-
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 Name | Description | Usage |
---|---|---|
aocTransID | This is the unique transaction id generated by AOC Gateway. This id is passed to the Service Provider during the getAOCToken API. | (STRING) Mandatory |
apiKey | This will be API Key to access AOC. Will be provided by BOOSTCONNECT. | (STRING) |
username | This will be the username provided to the Service Provider by BOOSTCONNECT. | (STRING) Mandatory |
msisdn | The MSISDN of the subscriber. The user’s MSISDN includes the country code, e.g. 60191234567. | (STRING) Mandatory |
tac | The TAC key-in by 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 Name | Description | Usage |
---|---|---|
transactionOperationStatus | The status of the charge transaction as below:
| (STRING) |
totalAmountCharged | This is the actual amount being charged. It can be a whole number or two digit decimal. | (DECIMAL) |
msisdn | The MSISDN of the target user. The user’s MSISDN includes the country code preceded by '+', e.g. +60191234567. | (STRING) |
clientCorrelator | This 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) |
errorCode | Please check on the error code list. | (STRING) |
errorMessage | Explanation of the error. | (STRING) |
Updated 3 days ago