Reward callback

InviteBox can be configured to make server-to-server calls to your application on the following events:

The former event is useful, for example, when you would like to generate unique discount codes for every user in an instant reward campaign. The latter option is useful for automating referral rewards in your application.

To enable this functionality, go to Widget settings -> Integration and click "Show API settings". Set "Reward callback" to the URL on your server to be called. Copy the "Secret key" value - this will be passed as a parameter to your callback and your application should check this value to prevent unauthorized access. 

The callback should accept POST requests with the following parameters:

The callback must return a JSON object. When the callback invoked on user making a post, the content of this object can be referenced in the text on the "thank you" page of the widget using [varname] placeholder where varname is the name of the object property. For example if you return {"coupon_code" : "ABCD12345"}, you can use "Thank you for spreading the word! Your coupon code is [coupon_code]." as the text. The returned JSON object is also available to the Javascript code on your page (or the one invoked by using "Execute Javascript code" reward) via "invitebox.secretExtra" reference. For example, to put promo code in a field like we do on invitebox.com, you could use something like this (using jQuery): $('#promo_code').val(invitebox.secretExtra.coupon_code);

Here's an example of server-side code in Python (using Django framework) from our own (instant reward-based) promo action:

def reward_callback(request):
    if request.method != "POST":
        return HttpResponseNotAllowed(["POST"])
    if request.POST.get('secret', None) != "our secret key":
        return HttpResponseForbidden()
    coupon = Coupon.objects.create()
    return HttpResponse(simplejson.dumps({"coupon_code" : coupon.code}),
                        mimetype='application/json')

And another example used by InviteBox's referral program (goal-based campaign):

def referral_callback(request):
    if request.method != 'POST':
        return HttpResponseNotAllowed(['POST'])
    if request.POST.get('secret', None) != 'our secret key':
        return HttpResponseForbidden()
    if request.POST.get('event',None) == 'referral':
        referrer_extra_vars = simplejson.loads(request.POST['referrer_extra_vars'])
        referrer = User.objects.get(id=referrer_extra_vars['user_id'])
        account = referrer.get_profile()
        ImpressionBonus.objects.create(account=referrer.get_profile(),
                                       impressions=500,
                                       note='main referral program')
        account.available_impressions += 500
        account.save()
    return HttpResponse(simplejson.dumps({}),
                        mimetype='application/json')