HomeAppVirality DocsAppVirality APIsCheck User Referral Issues

Check User Referral Issues

This API call will give the answers for questions raised from customers (End users) like:

  • I referred a friend; he signed up – we did not get the credits! Why?
  • My friend got the reward, but I did not. Why so?
  • My friend has done 5 transactions, but I am not getting my rewards. Why?

and many such typical questions which are common occurrences when you run Growth Hacks that offer incentives to your users.

Note: This call has a rate limit of 10 per minute.


Base URL  https://api.appvirality.com

 POST         v2_1/checkuserreferralissues/[API Key]

Content-Type application/json


Input i.e. Request

{
"apikey":"176502556c624614b913a62400ab4d7e",
"privatekey":"8b05ee42d9c941698bbba44c00cc32d1",
"referrerinput":"referrer@martinz.com",
"friendemail":"friend@martinz.com",
"campaignid":"283
}
Input Params
Input Params Description
apikey API Key of the App 
Get it from Dashboard >> App Details
privatekey Private key for API requests 
Get it from: Dashboard >> App Details >> Click App Settings >> Scroll down to Advanced Settings
referrerinput Email id or referral code of the referrer
friendemail Email id of the friend
campaignid
(optional)
Campaign id of the users

Response

{
    "success": true,
    "statuscode": 24,
    "message": "Friend has been marked as an Existing User."
}
Response Params
Output Params Description
success (Boolean) Status of the API call.
message Information regarding the users (referrer and friend) entered in the api request
status code code based on status of the API call

Status codes which you will see while using Check User Referral issues API

Status codes and description for API responses
Status Code Description
1 No Friend found for your input.
2 No Referrer found for your input.
3 No Friend found for your input. No Referrer found for your input.
4 Referrer doesn't belong to this campaign (Referrer campaign – XYZReferral).
5 Self-referral i.e user has referred to himself using the same device/email.
6 Friend has not entered a referral code.
7 Referrer and Friend attribution was successful.
8 Friend has been marked as an Existing User.
9 Friend has been marked as Suspicious.
10 Friend has been marked as Blocked.
11 Referrer has been marked as Blocked.
12 Referrer has reached the maximum reward capacity.
14 Conversion event (Install, Signup, ..) was successfully received.
15 Conversion event (Install, Signup, ..) was not received.
16 Conversion event was not received.
17 Friend has been marked as Suspicious because Referrer had been marked as Blocked.
18 Friend has been marked as Suspicious
19 Referrer has been marked as Blocked
20 Friend is already attributed to xyz@email.com.
21 Friend has been marked as Existing User, attributed to xyz@email.com.
22 Referrer and Friend attribution was not successful.
23 Friend was installed prior to the referrer.
24 Friend has been marked as an Existing User.
25 Friend has been marked as Existing User by App.
26 Device is already registered earlier with a different user xyz@email.com.
27 Friend has not clicked on referral link within the attribution time period.
28 Friend neither clicked on referral link nor provided referral code.
29 Either friend has entered a wrong or no referral code.
30 Friend has clicked referral link and installed from different IP's.
31 Either friend has not clicked on the referral link OR entered a wrong or no referral code.
32 Friend entered a wrong referral code – XYZ3723S.
Was this article helpful to you? Yes No 1