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
| Code | Description | User Allowed to Re-enter |
|---|---|---|
| 0 | Dropped | Yes |
| 100 | Complete | Yes |
| 200 | Terminated | Yes |
| 300 | Throttled | Yes, after 24 hours |
| 400 | Blacklisted | No |
Subcodes
| Code | Description |
|---|---|
| 0 | Dropped |
| 100 | Complete |
| 101 | Adjustment of status to complete |
| 201 | Reversal to termination |
| 202 | No surveys available for this user, entering into this project. (May be surveys if the user arrives to take a different project) |
| 205 | The user decided to exit the project |
| 210 | Over quota |
| 250 | Missing required URL Parameter |
| 251 | Invalid URL Parameter |
| 252 | Invalid URL Parameter; Session ID was reused |
| 260 | Incorrect hash on incoming URL |
| 270 | URL was replayed |
| 301 | Reversed but not permanently blocked (used on s2s calls) |
| 302 | No surveys available for this user for any project at this time. |
| 303 | Throttled for poor response quality |
| 400 | Blacklisted |
| 401 | Reversed and permanently blocked (used on s2s calls) |
Updated about 2 months ago
