Skip to content

This API call allows you to change the status of a reward from the server side directly


We have already laid out how there are 4 different statuses that a reward could be attested with, at any moment, depending on the rules of the campaign and the conversion event encountered.

Often, you would find it more comfortable to handle the change in these status directly from your side, instead of waiting for AppVirality to update them. This API call comes in handy for that.

Example: You would like to override and change status of a reward (which is linked to the Transaction event) immediately after you have confirmation that the product has been delivered successfully & no returns would be filed for the same.
This would allow you to update the user rewards as soon as the user states that he would not be returning the order

POSTapi.appvirality.com/v2_0/changerewardstatusapplication/json

Input i.e. Request

{
"apikey":"7ffdda00fd5c4338a9c1a44e00663648",
"privatekey":"d1e881dc60fa4856be34a44f00d96c9a",
"rewardslist":[
{
"rewarddtlid":"797",
"reward_status":"Approved"
}
]
}

Input Params

Input ParamsDescription
apikeyAPI Key of the App
Get it from DashboardApp Details
privatekeyPrivate key for API requests
Get it from: DashboardApp Details › Click App Settings › Scroll down to Advanced Settings
rewardslistRewards List
~ rewarddtlidReward Detail ID
~ reward_statusReward status can be: Approved, Rejected, Suspicious, Under Review

Response

{
"success":true,
"statuscode": 1,
"message":success
}

Response Params

Output ParamsDescription
successreturns true on successful update
status codecode based on status of the API call
messageInformation regarding API call (if relevant)

Status codes which you will see while using Change Reward Status API

Status codes and description for API responses

Status CodeDescription
0No data found for the search criteria
1Success