For Developers

Embed rewards.
Keep your product in control.

Integrate RibiRewards into your product or platform and issue rewards, manage recipients, and track outcomes across Africa — all through a simple, secure API.

Get API access View documentation

Simple, powerful APIs. Built for scale.

Sandbox environment. Test before you go live.

Dedicated support. From integration to launch.

RequestResponsecURLPythonNode.js● Live API

POST

/v1/rewards

{
  "recipient": {
    "phone": "+254712345678",
    "country": "KE"
  },
  "reward": {
    "type": "airtime",
    "value": 500,
    "currency": "KES"
  }
}

202 Accepted

Request received10:24:11

Processing10:24:33

Delivered10:24:25

Recipient notified10:24:26

Real rewards.
Real impact.
Across Africa.

PROGRAMMES LIVE WITH

Heineken Beverages

Pernod Ricard

Golden Penny

AND ACROSS

FMCGBanks & FintechResearchInsurance

One API. The full lifecycle.

From request to real-world impact.

Handle the entire rewards journey through a single integration. Issue, fulfil, track and reconcile — in real time.

Issue

Create a reward request from your product or workflow.

Recipient

Send via the recipient's preferred channel (WhatsApp, SMS, USSD, Web, POS).

Catalogue

Choose from 50+ local and global reward options across African markets.

Fulfil

We deliver instantly via our local partners and operators.

Webhook

Get real-time updates on delivery, redemption and status changes.

Reconcile

Track performance and export reports for your records.

How it works

A flexible architecture built for your needs.

Integrate in minutes and let RibiRewards handle local complexity — from provider routing and fulfilment to tracking and reconciliation.

Simple REST APIs

Real-time webhooks

Multi-market, multi-currency

Built-in fraud checks

Idempotency and retry logic

Sandbox and live environments

View technical docs

Your product or platform

Web app

Mobile app

ERP / CRM

Internal tools

Marketplace

RibiRewards API

Authentication

Reward engine

Rules & validation

Provider network

Fulfilment & delivery

Webhooks & events

Local providers

Mobile networks

Gift card partners

Retail & eCommerce

Payment providers

Experiences & travel

Recipients

SMS

USSD

Web

POS / In-person

Get started

Developer-friendly tools and SDKs.

Use our SDKs or make direct API calls. Full documentation, code examples and support to help you build quickly.

View all code examples

cURLNode.jsPythonPHP

curl -X POST https://api.ribirewards.com/v1/rewards \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "phone": "+254712345678",
      "country": "KE"
    },
    "reward": {
      "type": "airtime",
      "value": 500,
      "currency": "KES"
    },
    "reference": "campaign_123"
  }'

Webhook events

Stay in the loop.

Get real-time notifications at every stage of the reward lifecycle.

View webhook docs

POSTreward.created

The reward request has been received.

~ 0s

POSTreward.processing

The reward is being delivered.

~ 5s

POSTreward.delivered

The reward has been successfully delivered.

~ 10s

POSTreward.redeemed

The recipient has redeemed the reward.

~ 1–24h

Built for scale

Reliable. Secure. Compliant.

Enterprise-grade infrastructure to power your reward experiences.

99.99%API availability

SecureOAuth 2.0 & encryption

CompliantKYC, AML & local regulations

Multi-market30+ African markets

High performanceBuilt for scale

READY TO BUILD?

Let's power your product with rewards.

Tell us what you want to achieve. We’ll help you design the right programme and infrastructure.

Talk to sales Explore platform

Embed rewards.
Keep your product in control.

Integrate RibiRewards into your product or platform and issue rewards, manage recipients, and track outcomes across Africa — all through a simple, secure API.

Simple, powerful APIs. Built for scale.

Sandbox environment. Test before you go live.

Dedicated support. From integration to launch.

curl -X POST https://api.ribirewards.com/v1/rewards \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "recipient": { "phone": "+254712345678", "country": "KE" }, "reward": { "type": "airtime", "value": 500, "currency": "KES" }, "reference": "campaign_123" }'

Embed rewards.Keep your product in control.

From request to real-world impact.

A flexible architecture built for your needs.

Developer-friendly tools and SDKs.

Stay in the loop.

Reliable. Secure. Compliant.

Let's power your product with rewards.

Embed rewards.Keep your product in control.

From request to real-world impact.

A flexible architecture built for your needs.

Developer-friendly tools and SDKs.

Stay in the loop.

Reliable. Secure. Compliant.

Let's power your product with rewards.

Embed rewards.
Keep your product in control.

Embed rewards.
Keep your product in control.