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 API workflow

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.

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

Select an eligible reward option from the configured catalogue for the programme and market.

Fulfil

Route fulfilment through the configured local delivery rail and provider.

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

Validation before fulfilment

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 the REST interface directly and follow the documented request, status and webhook patterns. Treat the examples as integration guides and confirm production credentials and enabled capabilities during onboarding.

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.

The integration model is designed around authenticated requests, programme references, lifecycle status, retries and operational visibility.

ControlledAuthenticated API access

TraceableReferences and lifecycle status

ResilientIdempotency and retry patterns

ObservableWebhook and reporting events

Multi-marketOne integration, local execution

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.

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

Validation before fulfilment

Idempotency and retry logic

Sandbox and live environments

View technical docs

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" }'

Reliable. Secure. Compliant.

The integration model is designed around authenticated requests, programme references, lifecycle status, retries and operational visibility.

ControlledAuthenticated API access

TraceableReferences and lifecycle status

ResilientIdempotency and retry patterns

ObservableWebhook and reporting events

Multi-marketOne integration, local execution

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.