Redirects & S2S & Status Codes

Your postbacks and redirects can be set through the dashboard yourself. You can also choose whether to receive it as a POST or GET request. POST is default.

Postbacks support only completes & adjustments (adjusted completes & reversals). Redirects support all statuses except adjustments (adjusted completes & reversals). You have to specify each variable below, except for hash which is auto appended. Example:

https://domain.com/postbacks/cherries?userid={pid}&status={status}&subcode={subcode}&reward={user_reward}&earned={earned}&ip={ipaddress}

Parameters

Parameter

Value

sid

Supplier ID provided by Cherries

pid

Unique user ID determined by the supplier

mid

Unique session ID determined by the supplier

status

Status code describing the outcome of the session. See below for status codes

subcode

Status subcode describing the outcome of the session in more detail. See below for status subcodes

hash

Hash of the entire return URL minus this parameter. This should always be the final parameter in the URL. Follows SHA-256 hash protocol detailed in the hashing article Hashing

transaction_id

Unique transaction ID from Cherries

earned

Earnings of supplier in USD (Decimal format, 0.9= $0.9, 1=$1). Will be a negative value on a reversal.

user_reward

Reward the user receives. Will be a negative value on a reversal.

ipaddress

IP address of the user

datetime

iso format timestamp

timestamp

Unix format rounded to nearest second

timestamp_micro

Unix format include microseconds


Status codes

CodeDescriptionUser Allowed to Re-enter
0DroppedYes
100CompleteYes
200TerminatedYes
300ThrottledYes, after 24 hours
400BlacklistedNo

Subcodes

CodeDescription
0Dropped
100Complete
101Adjustment of status to complete
201Reversal to termination
202No surveys available for this user, entering into this project. (May be surveys if the user arrives to take a different project)
205The user decided to exit the project
210Over quota
250Missing required URL Parameter
251Invalid URL Parameter
252Invalid URL Parameter; Session ID was reused
260Incorrect hash on incoming URL
270URL was replayed
301Reversed but not permanently blocked (used on s2s calls)
302No surveys available for this user for any project at this time.
303Throttled for poor response quality
400Blacklisted
401Reversed and permanently blocked (used on s2s calls)