Postback data | Besitos Knowledge Base

After setup, you'll receive a postback at the webhook URL each time a conversion occurs from your traffic sources, typically within 10 minutes of the event.

If the webhook does not receive a successful (200) response, it will retry five more times before considering the postback failed. Investigate why your webhook is not receiving postback. If using our APIs, refer to the Conversion Data API for conversion data.

Examples of postback data

You will get postback data as a GET response. Data varies by offer type.

Game conversion

 [user_id] => tWAek9twniogX0e
    [transaction_id] => 2601367
    [reward] => 0.00
    [payout] => 17.55
    [offer_id] => ZdpmgapG21vK
    [offer_name] => Family Island
    [note] => Successfully installed the app
    [reward_local_currency] => 60
    [goal_id] => ZdpmgapG21vK_0
    [verifier] => 94706b9cefb5b1c78c62adf8ea402c2db42c18159f4e05f737880af69f60ceed

Survey conversion

[user_id] => tWAek9twniogX0e
    [transaction_id] => 6216222
    [reward] => 1.00
    [payout] => .40
    [survey_id] => 61
    [type] => survey
    [note] => Survey completion reward
    [reward_local_currency] => 1.00
    [verifier] => 94706b9cefb5b1c78c62adf8ea402c2db42c18159f4e05f737880af69f60ceed

Deal conversion

 [user_id] => tWAek9twniogX0e
    [transaction_id] => 6216220
    [reward] => 60.00
    [payout] => 100.75
    [deal_id] => tv1657278769
    [type] => deal
    [deal_name] => Perpay - Shop and Build Credit
    [note] => First Installment Paid
    [reward_local_currency] => 60
    [goal_id] => tv1657278769_0
    [verifier] => 94706b9cefb5b1c78c62adf8ea402c2db42c18159f4e05f737880af69f60ceed

Response attributes

Attribute	Data type	Description	Example
`user_id`	string	The user's unique ID. Values are case-insensitive.	`asdfn-234ghhh`
`transaction_id`	string	The unique transaction ID for tracking conversions. If received twice, do not process it unless reverse+1 is included to indicate a reversal.	`45415`
`reward`	numeric	The user's reward in USD.	`5.50`
`payout`	numeric	The reward amount confirmed for payout to you, the partner, in USD.	`3.25`
`reward_local_currency`	numeric	The user's reward in your currency (i.e., points or coins) multiplied by its ratio to USD. If no ratio is given, it will be shown in USD.	`4`
`offer_id`	string	The unique offer ID identifies a game the user is playing or has played.	`dgh471b5kgcn`
`offer_name`	string	The name of the game the user is playing. This only applies to games.	`Coin Master`
`note`	string	This explains the reason for the reward.	`Level 91 Reached`
`reverse`	boolean	If a reversal occurs, `reverse=1` will be sent; otherwise, the parameter will not be sent. The reversed amount will be sent in `reward` and `reward_local_currency`. Reversals typically occur when a user is no longer eligible for an offer. For example, they previously installed the game.	`1`
`info`	string	This is an optional parameter in your webpage URL. It will not be returned if you did not provide it in the URL.	`market_research`
`verifier`	string	The verifier should match the calculated webhook hash.	`fc002ee7b52e628facfa6645416a8d052e3d9681e85251b9ef6547798f75276f`
API*
`goal_id`	string	The unique identifier of the goal accomplished by the user. You will only receive this data if you have enabled API. It will not* be included in survey data.	`ZdpmgapG21vK_665`
Game*
`type`	string	If you enable surveys or deals in addition to games, `type` will be included in the game conversion data.	`offer`
Survey*
`type`	string	If you enabled surveys for your users, the type will be "survey."	`survey`
`survey_ID`	string	The unique survey ID.	`4bdc56x7`
Deal*
`type`	string	If you enabled deals for your users, the type will be "deal".	`deal`
`deal_id`	string	The unique deal ID.	`tv1657278769`
`deal_name`	string	The deal name as it appears on the offer.	`Perpay - Shop and Build Credit`

*The attributes in these sections will only be posted if you have enabled the API, Surveys, or Deals, respectively. Contact your Besitos Account Manager at [email protected] if you'd like to enable the API or Surveys.