> For the complete documentation index, see [llms.txt](https://sparkwall.gitbook.io/sparkwall-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sparkwall.gitbook.io/sparkwall-docs/postbacks.md).

# 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:

```markdown
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:

<table><thead><tr><th width="373">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>{user_id}</td><td>Unique User Identifier</td></tr><tr><td>{amount}</td><td>Reward in App Currency</td></tr><tr><td>{payout}</td><td>Reward in US-$</td></tr><tr><td>{transaction_id}</td><td>Unique Transaction ID</td></tr><tr><td>{user_ip}</td><td>User's IP Address</td></tr><tr><td>{offername}</td><td>Offer name</td></tr><tr><td>{offerid}</td><td>Offer ID</td></tr><tr><td>{status}</td><td>1 (Credit) / 2 (Chargeback)</td></tr><tr><td>{signature}</td><td>Signature parameter should match MD5 of {user_id} {transaction_id} {payout} secret_key</td></tr></tbody></table>

## Status Code

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