Offer Server Callbacks

When a user clicks or completes an offer goal (examples: Download App, Reach Level 7, etc.), inBrain provides callback data to your server via a POST request containing a payload of data.

Configuring Offer Callbacks

Callback URL's are configured within the dashboard on https://publisher.inbrain.ai.

Offer Conversion Callback Payload

POST http://yourdomainname.com/path/to/your/successendpoint
{
  "Sig": "e4d909c290d0fb1ca068ffaddf22cbd0",
  "OfferId": 12345,
  "OfferGoalId": 12345,
  "OfferTitle": "Complete Game Levels and earn",
  "PanelistId": "user-xyz-789",
  "RewardType": "offer_completed",
  "RewardId": "9f1c2b70-1f32-4c21-a5ad-3a74c4a7e7f9",
  "Reward": 2.50,
  "RevenueAmount": 5.75,
  "ClientId": "8y1c2b70-1f32-4c21-a5ad-3a74c4a7e7f9",
  "Timestamp": "2025-06-25T14:00:00Z"
}

Offer Click Callback Payload

POST http://yourdomainname.com/path/to/your/successendpoint
{
  "Sig": "e4d909c290d0fb1ca068ffaddf22cbd0",
  "OfferId": 12345,
  "OfferGoalId": null,
  "OfferTitle": "Complete Game Levels and earn",
  "PanelistId": "user-xyz-789",
  "RewardType": "offer_clicked",
  "RewardId": "9f1c2b70-1f32-4c21-a5ad-3a74c4a7e7f9",
  "Reward": 0,
  "RevenueAmount": 0,
  "ClientId": "8y1c2b70-1f32-4c21-a5ad-3a74c4a7e7f9",
  "Timestamp": "2025-06-25T14:00:00Z"
}

Explanation of Payload Properties

Property	Type	Description
Sig	string	Signature used to verify the authenticity of the callback request. See the next section for details on verifying requests using Sig.
PanelistId	string	The unique user id provided by the partner.
OfferId	int	Internal ID of the offer from the system.
OfferGoalId	string	Internal ID for the goal or sub-action associated with the offer. Optional.
OfferTitle	string	Title of the offer provided for basic display purposes.
RewardType	string	The type of reward event. For offer conversions, the value will be "offer_completed". Other possible values include: "offer_clicked”, ”offer_completion_reversed"
RewardId	string	A globally unique identifier (GUID) for the reward event. Can be used to detect and ignore duplicate callbacks.
Reward	decimal	The amount of in-app currency (IAC) awarded to the user. This is determined by your publisher configuration.
RevenueAmount	decimal	Revenue amount in USD earned from the offer conversion.
ClientId	string	Identifier for the integration clientId that generated the callback.
Timestamp	string	ISO 8601 UTC-formatted timestamp indicating when the event occurred.

Signature Validation

To compute and verify the ‘Sig’ property of a callback request, combine the following properties along with the Callback Secret found in the ​Callback ​tab of your publisher dashboard:

[PanelistId] + [RewardId] + [CallbackSecret]

Next compute an MD5 hash of the resulting concatenated string. The result should be a hash value matching the Sig property in the callback request.