Quickstarts
React Native integration
Prepare a React Native placement, authenticate your user and verify rewards.
Prepare your placement
Register an app or site in the publisher workspace, choose the integration method, then create a placement. Configure its reward currency and signed callback endpoint. Your account’s enabled integrations determine which methods you can activate.
Check availability and obtain the SDK
Select react_native only when your account’s enabled integrations include it. Obtain the approved React Native artifact and version-specific installation instructions from integration setup. A method in the API enum does not guarantee an available binary. If the method is unavailable, use an enabled hosted route or the Offer API.
Establish a scoped session
Exchange a short-lived publisher-server-signed JWS HS256 assertion and public SDK key through the offerwall session endpoint. The assertion binds issuer, audience KRIN, opaque user subject, app, placement, issued/expiry times and a unique nonce. Its lifetime is at most five minutes. Keep the signing secret on your server. The returned 15-minute token is scoped to one user, app and placement; a public SDK key or browser user ID cannot authenticate that user.
Integrate with the host lifecycle
Initialize with public placement configuration. Open the wall after an explicit user action, close it when the host screen leaves, and restore focus or navigation. Handle unavailable content and session expiry. Keep publisher signing and reward crediting on the server.
Verify the full reward journey
Run a publisher postback test, including duplicate and reversal handling. Check signature verification, the durable event record, callback delivery and your server’s acknowledgement separately. Record the user credit receipt after your own ledger commits. A transport response alone does not prove a user was credited.