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

ParameterValue
sidSupplier ID provided by Cherries
pidUnique user ID determined by the supplier
midUnique session ID determined by the supplier
statusStatus code describing the outcome of the session. See below for
status codes
subcodeStatus subcode describing the outcome of the session in more detail. See below for
status subcodes
hashHash 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_idUnique transaction ID from Cherries
earnedEarnings of supplier in USD (Decimal format, 0.9= $0.9, 1=$1). Will be a negative value on a reversal.
user_rewardReward the user receives. Will be a negative value on a reversal.
ipaddressIP address of the user
datetimeiso format timestamp
timestampUnix format rounded to nearest second
timestamp_microUnix 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)


Did this page help you?