For developers
Offerwall SDK and API for Android, iOS and web apps
Put a rewarded offerwall in your app with one call. The SDK opens the hosted wall, our server tells yours when a user earns, and your secret key never ships inside the app.
What usually goes wrong with an offerwall integration
Secrets inside the app
Anything in an APK or IPA is public. An SDK that needs your secret key gives it away.
Rewards credited from the client
If the app decides a user has earned, anyone with a debugger can earn as much as they like.
Callbacks you cannot test
Without a test postback you find out your endpoint is broken when users start complaining.
What you get
Android SDK
A Kotlin library for Android 5.0 and up with no dependencies, plus a prebuilt AAR. OfferwallGG.show() opens the wall; OfferwallView embeds it.
iOS SDK
A Swift package for iOS 13 and up with no dependencies, with a view controller and a SwiftUI view.
Web wall
One URL with your public key and the user's id, in an iframe, a tab or Telegram's built-in browser.
REST API
Offers, surveys and paid website visits as JSON from your server, for building your own list.
Signed postbacks
Every completion and reversal is signed with your secret. Check it in PHP, Node or Python with our examples.
Plugins
A WordPress plugin and addons for VieFaucet and ClaimBits, if your site runs one of those.
Pick the integration that fits
Native Android or iOS app
Use the SDK. Your server signs the link and credits users from the postback.
Website or web app
Use the wall link in an iframe or a new tab. Nothing to install.
Custom offer list
Call the API from your server and draw the offers in your own UI.
Telegram mini app or bot
Load the wall link inside the mini app, or open it from a bot button.
From zero to first reward
-
Create a placement
You get a public key for the wall and a secret key for your server.
-
Open the wall
Call the SDK with the public key and your user's id, or build the wall link.
-
Receive the postback
Check the signature, credit the user once per transaction id, answer 200.
-
Fire a test
Send a test credit and a test reversal from the dashboard and watch your server's answer.
Frequently asked questions
Is the offerwall SDK free?
Yes. The Android and iOS SDKs, the plugins and the API cost nothing. You earn on every offer your users complete.
Why is the SDK a web view and not a native list?
The API needs your secret key, and anything inside an app can be read by anyone who downloads it. The SDK shows the hosted wall with your public key only, and rewards are credited from your server.
Which Android and iOS versions are supported?
Android 5.0 (API 21) and up, and iOS 13 and up. Neither SDK has third-party dependencies.
Can I use the offerwall in a Telegram mini app?
Yes. Load your wall link inside the mini app with your user's id, add the mini app's domain to your placement's allowed embedding domains, and credit users from the postback.
How do I verify a postback?
Each postback carries a signature made with your secret key over the user id, transaction id and amount as sent. The developer docs show the check in PHP, Node and Python.
Do I need an SDK for a website?
No. A website only needs the wall link, in an iframe or a new tab.
Related pages
Get your keys and the SDK
Sign up free, create a placement and download the SDK with everything you need to show the wall today.