Server to Server Callback Feature (Optional)

Server to Server Callback Feature for Unsubscribed User

Operator Customer Service will unsubscribe users from the AOC platform if there is any complaint or request from the user. When customer service successfully unsubscribes a user, AOC will invoke a callback to Service Provider Unsubscribe Callback URL.

The callback will be a HTTP POST call and JSON payload.

{ "data": 
{ 
    "subscriptionID":"WeeklyGame1",
    "msisdn":"+60191234567", 
    "status":"unsubscribed" 
} 
}

📘

Note

Service Providers need to provide this callback URL to BOOSTCONNECT operation during on-boarding process and it’s optional.

Server to Server Callback Feature for Auto-Renewal Subscription

For some Operators, Service Providers do not need to invoke the renewal of subscription. The renewal charge process will be automatically done. Once the renewal charge succeeds, AOC will invoke a callback to Service Provider Callback URL (same callback URL for a charge).

The callback will be a HTTP POST call and JSON payload.

{ "data": 
{ 
  "aocTransID":"T387487", 
    "transactionOperationStatus":"charged", 
    "totalAmountCharged":"1.00", 
    "clientCorrelator":"R-c559c5f7-2bd9-4bda-9514-86e039b82b22", 
    "msisdn":"+601234567", 
    "expiryDate":"17-06-2018", 
    "subscriptionID":"Sub1", 
    "errorCode":"00", 
    "errorMessage":"" 
} 
}

Server to Server Callback Feature for Split Charge

For Subscription under Split Charge (charge with minimum amount), the server to server callback will be as below;

{ "data": 
{ 
  "aocTransID": "T387487", 
  "transactionOperationStatus": "charged", 
  "totalAmountCharged": "1.00", 
  "clientCorrelator": "R-c559c5f7-2bd9-4bda-9514-86e039b82b22", 
  "msisdn": "+601234567",
  "expiryDate": "17-06-2018",
  "subscriptionID": "Sub1",
  "chargeMode": "split",
  "errorCode": "00",
  "errorMessage": "" 
} 
}

Server to Server Callback Feature for Step Down Charge

For Subscription under Step Down Charge (user choose step down option with lower amount and subscription duration), the server to server callback will be as below;

{ "data":
{ 
  "transactionOperationStatus": "Charged",
  "totalAmountCharged": "5.00",
  "msisdn": "+60191234567",
  "aocTransID": "12345678",
  "clientCorrelator": "12345678901234567",
  "expiryDate": "22-07-2020",
  "subscriptionID": "Sub1",
  "chargeMode": "stepdown",
  "subscriptionDuration": 8,
  "errorCode": "00",
  "errorMessage": ""
}
}

📘

Note

In case the charge is not successful, we will return “Denied” status to you.