⛓️Postbacks

We'll use postbacks to notify your server of successful conversions. This data empowers you to reward your users.

URL

Your Postback URL is your server endpoint that expects calls from our server. An example Postback URL might look like this:

https://example.com/spark?user_id={user_id}&amount={amount}&payout={payout}&transaction_id={transaction_id}&user_ip={user_ip}&offername={offername}&offerid={offerid}&status={status}&signature={signature}

Macros

The following macros are available and will be replaced dynamically when sending you the postback:

Parameter	Description
{user_id}	Unique User Identifier
{amount}	Reward in App Currency
{payout}	Reward in US-$
{transaction_id}	Unique Transaction ID
{user_ip}	User's IP Address
{offername}	Offer name
{offerid}	Offer ID
{status}	1 (Credit) / 2 (Chargeback)
{signature}	Signature parameter should match MD5 of {user_id} {transaction_id} {payout} secret_key

Status Code

Please return status code 200, if you have successfully processed the postback.