Skip to main content

S2S Callbacks

The Callback is the basis by which you can reward your users. The Callback is a GET request that is sent to your processing script upon the conclusion of a transaction - either a complete C, screenout F, or overquota P.

This request contains important information about which user needs to be rewarded, what offer was taken, and how much virtual currency they should be paid.

Setup Callback​

RapidoReach supports secure hasing on system-to-system callbacks. Please reach out to a RapidoReach account manager to configure the Callback URL. Follow the steps below to complete your setup.

How to create a Processing Script​

  1. Create an endpoint that can receive a GET request to its location.

  2. Reward your users for completes and screen-out rewards (if applicable).

  3. Store information in your database

  4. Respond with a 1 if callback received & processed correctly and 0 if you require us to repeat the callback (can be repeated three more times).

Add the Callback to your application​

  • Go to Apps section.

  • Select your Application.

  • Click on the Callback section.

Update callback url

  • Click on the Setup Callback button.

  • Enter your Callback URL.

  • Click Save button.

Sample callback request​

Parameters will be appended with their corresponding variables after the processing script location as follows:

app-domain.com/callback?cmd=transactionComplete&userId=user123-9370-d163590aa9
&amt=100&offerInvitationId=1234&status=C&oiHash=2ef1130cca32cd030141d8935dec0992
&currencyAmt=20000&transactionId=4321&endUserId=user123&offerTitle=TestProject
&useragent=RapidoReach&profiler=&currencyName=Chachingz&offerType=survey
&txnHash=66a2b2987083666c76592d505240748e&program=&transactionSource=iframe&

Callback Parameters​

ParameterTypeDescription
cmdstringwill always be transactionComplete.
userIdstringRapidoReach userId as generated earlier.
endUserIdstringEnd user id which you are using whithin app/website for your user.
amtnumberAmount paid in dollars to you for this particular transaction.
offerInvitationIdstringEnables you to remember for which offer a user has been rewarded for.
statusstringQUOTAFULL - user screened out of survey, the required number of responses from this demographic has already been met., COMPLETE - user successfully completed the transaction., TERMINATION - user screened out of survey, does not have the relevant attributes needed.
oidHashstring?> 32 character hex string = md5(concat(offerInvitationId, applicationKey)) You should verify oidHash upon receipt of the callback by recomputing it with the callback offerInvitationId and your ApplicationKey. This will secure against users faking their own id and passing it in if by some chance they come across the script.
currencyAmtnumberPayout to user in your virtual currency. Important for screenout rewards.integer (default) or float (on request). Indicates how many points the user should get in your site’s virtual currency. Based on your configured conversion rate on the control panel. Negative values indicate chargebacks.
transactionIdstringUnique ID representing a single user participating in a single survey/offer, please include if requesting support for a particular transaction.
txnHashstring32 character hex string = md5(concat(transactionId, current TransactionKey)) You can find your TransactionKey in your Application list.
sub_idstringOptional alias identifier to track traffic on campaigns, can be used for testing and segmentation purposes. Please ask our team to enable sub_id for you.

IP Whitelist​

We highly recommend whitelisting the following IPs to secure your system from fraudulent callbacks. If the following list is update, you will be notified via email prior to the change.

161.97.78.55, 173.212.227.149, 75.119.139.250, 75.119.139.251

Setup callback IP whitelist​

  • Go to Apps section.

  • Select your application.

  • Click on the Callback section.

  • Under the IP Whitelist section click the Copy IP Whitelist button to copy the IPs to your clipboard.

How to Test the Callback​

The Test Callback button will generate a test complete. The test complete will fire a callback to the specified URL. It is best to test callbacks before deploying the app in production.

First ensure that you have whitelisted the IPs listed in the above section.

Instructions​

  • Go to Apps section.

  • Select your Application.

  • Click on the Callback section.

  • Click on the Test Callback button.

Test callback url

  • Fill out the form with the parameters you want and click the invoke Test Callback button.

  • Get your results.