Guides

Server to Server Callback Feature (Optional)

Suggest Edits

Service Providers need to provide this callback URL to BOOST CONNECT operation during the onboarding process. The callback will be an HTTP POST call and JSON payload.

HTTP Method
POST

Server to Server Callback for Service Provider

Besides the user browser redirection back to Service Provider, there will be a server-to-server callback for IOD and subscription success charge transaction.

📘

Note

This callback feature will only happen for successful transactions and it’s optional.

For IOD transactions, the server-to-server callback will be as below;

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

For subscription transactions, there will be 2 additional parameters (expiryDate and subscriptionID) returned which are as below;

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

📘

Note

For e-Wallet transactions, there will be no MSISDN return.

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":
{
	"transactionOperationStatus": "Charged",
	"totalAmountCharged": "5.00",
	"msisdn": "+60191234567",
	"aocTransID": "12345678",
	"clientCorrelator": "12345678901234567",
	"expiryDate": "22-07-2020",
	"subscriptionID": "Sub1",
	"chargeMode": "split",
	"errorCode": "00",
	"errorMessage": ""
}
}

For server-to-server callback for charge success on the remaining amount under Split Charge subscription will be as below;

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

Server to Server Callback Feature for Step Down Charge

For Subscription under Step Down Charge (user chooses 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": ""
}
}

Server to Server Callback Feature for Parking Logic

For server-to-server callback for charge success on the recoup amount for subscription fee under Parking Logic will be as below;

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

📘

Note

The chargeMode value could be “standard”, “split” or “stepdown”. If it’s stepdown, the subscriptionDuration will be included as well.

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. 

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

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).

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

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

Updated about 2 years ago