Request Charging Status

Once Service Provider receives the request on the callback URL from AOC Gateway, they need to invoke the “Request Charging Status” API to get the status of the charging transaction.

Then, Service Provider needs to display a success or failed page to the user/payer.


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


Request Parameter

Request ParameterDescriptionUsage
aocTransIDThis is the unique transaction id generated by AOC Gateway. This id is passed to Service Provider’s Callback URL.(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


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

{ "data": 

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 sections “Processing Status for Operator XL” and “Processing Status for PayTM Wallet” for more details).
4. pending_consent (mean the transaction is still pending user consent. This status is only applicable for certain Operator).
5. pending_topup (mean the transaction is still pending user process to top-up their balance before recharge. This status is only applicable for certain Operator).
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.

Note: For e-Wallet transactions, there will be no MSISDN return.
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)