Introduction to Affike
Welcome to the Affike documentation. Here you will find all required information to integrate our offerwall into your website or app in just a few minutes.
Before moving forward:Ensure you're registered on Affike. An account is required to use any of our tools.
Add your Placement
In order to integrate our Affike Offerwall, first you have to add your app/website placement. Once you have your placement approved, you will have an API KEY and a SECRET KEY that you will need to integrate our Offerwall.
Steps to add your placement
- 1
- 2
Go to your Publisher Dashboard and click on "Placements"
- 3
Click "Create Placement" and fill up the form
- 4
Allow us up to 24 hours to check your placement request
Within 24 hours, your account will be approved by our team. After that, make sure to add your postback and reward configs (Exchange Rate, Currency Name, etc.)
After approval: You can either use iFrame or Offers API to access our offers. We advise you to use iFrame if you run a simple Rewarding Platform, otherwise go with Offers API.
Website Integration
If you are looking to integrate the offerwall into your website, either open the offerwall in a new tab or show the offerwall in an iframe.
JavaScript Integration
Open the offerwall in a new browser tab:
window.open("https://affike.com/offerwall/[API_KEY]/[USER_ID]")iFrame Integration
Embed the offerwall directly in your page:
<iframe
src="https://affike.com/offerwall/[API_KEY]/[USER_ID]"
width="100%"
height="600"
frameborder="0"
scrolling="yes">
</iframe>Parameters
[API_KEY]- Your unique API key from the Publisher Dashboard[USER_ID]- The unique identifier of the user viewing the offerwall
Optional Parameters
You can pass additional parameters to customize the offerwall experience:
https://affike.com/offerwall/[API_KEY]/[USER_ID]?subid=[SUBID]&country=[COUNTRY]subid- Custom tracking parameter for your analyticscountry- Filter offers by country (ISO 3166-1 alpha-2)
Postback Setup
Configure your server-to-server postback URL to receive conversion notifications and reward your users automatically.
Postback URL Format
We will send a GET request to your postback URL with the following parameters:
https://yoursite.com/postback?user_id={user_id}&payout={payout}&offer_id={offer_id}&transaction_id={transaction_id}&signature={signature}Available Macros
| Macro | Description |
|---|---|
{user_id} | The user ID you passed in the offerwall URL |
{payout} | The payout amount for this conversion |
{offer_id} | The unique offer identifier |
{offer_name} | The name of the completed offer |
{transaction_id} | Unique transaction ID for this conversion |
{subid} | Your custom subid if provided |
{signature} | HMAC signature for security verification |
{ip} | User's IP address |
Response Codes
Your server should respond with one of the following:
200 OK- Conversion processed successfully400 Bad Request- Invalid parameters409 Conflict- Duplicate transaction
Security
Verify postback authenticity using the signature parameter to prevent fraud.
Signature Verification
The signature is generated using HMAC-SHA256 with your Secret Key:
// PHP Example
$secret_key = "YOUR_SECRET_KEY";
$string_to_sign = $user_id . $payout . $transaction_id;
$expected_signature = hash_hmac('sha256', $string_to_sign, $secret_key);
if ($signature === $expected_signature) {
// Valid postback - process the conversion
} else {
// Invalid signature - reject the request
}// Node.js Example
const crypto = require('crypto');
const secretKey = "YOUR_SECRET_KEY";
const stringToSign = user_id + payout + transaction_id;
const expectedSignature = crypto
.createHmac('sha256', secretKey)
.update(stringToSign)
.digest('hex');
if (signature === expectedSignature) {
// Valid postback - process the conversion
} else {
// Invalid signature - reject the request
}Important: Always verify the signature before crediting users. Never expose your Secret Key in client-side code.
Frequently Asked Questions
How long does placement approval take?
Placement approval typically takes up to 24 hours. You will receive an email notification once your placement is approved.
What is the minimum payout threshold?
The minimum payout threshold is $50. Payments are processed on a NET-30 basis.
Can I use Affike on mobile apps?
Yes! You can integrate our offerwall into iOS and Android apps using a WebView component with the same iframe/URL integration method.
How do I test the integration?
Enable "Test Mode" in your placement settings to receive test postbacks without real conversions.
Need Help?
If you have any questions or need assistance with integration, our support team is here to help.