Introduction

Onari is gamification infrastructure for apps in Africa. Your server sends Onari the things your customers do (an order, a transfer, a top-up). Your team builds campaigns around them in the Onari dashboard. Onari tracks every player's progress, decides who wins, keeps to your budget, and tells your server to pay out.

How it fits togetherCopy Anchor Link

1. Your server sends events. POST /v1/events with a player ID you choose and an event like order.placed. See Events.
2. Your team runs campaigns. Challenges, streaks, leaderboards, referrals and trivia, each with a reward, a budget and an audience. See Campaigns.
3. Onari picks the winners. Exactly once per win, never past your budget, even when events arrive at the same time.
4. You pay out. Onari sends a signed reward.issued webhook to your server. Voucher codes are handed out by Onari itself. See Webhooks.
5. Players see it all in the Rewards Hub, a white-label page you open inside your app. See Rewards Hub.

Where to startCopy Anchor Link

The basicsCopy Anchor Link

• Base URL: https://api.onari.xyz
• Auth: your secret key in Authorization: Bearer sk_test_… (sandbox) or sk_live_… (live). Only call Onari from your server.
• Amounts are integers in minor units: 250000 is ₦2,500.00.
• Player IDs are yours. Never send names, phone numbers, emails or BVN.