Kopokopo

Automate Kopokopo M-Pesa payments, payouts, and settlements via OAuth 2.0 and STK Push.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill kopokopo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Kopokopo
Source: https://github.com/AfricanDigitalAssetFramework/africa-stack-skills/tree/main/east-africa/kopokopo
Command: npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill kopokopo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kopokopo integration solves the complexity of accepting M-Pesa payments, issuing merchant payouts, and settling funds, all via a single, consistent API surface.

Core Features & Use Cases

  • End-to-end payments: Collect customer payments using STK Push and webhook confirmations for reconciliation.
  • Payouts & settlements: Disburse funds to merchants or bank accounts with tracking references and failure handling.
  • Real-world scenarios: E-commerce checkout, marketplace merchant payouts, and subscription billings with automated reconciliation.

Quick Start

Set up Kopokopo MPesa payments in Kenya and test STK Push flows with webhook callbacks.

Frequently Asked Questions about Kopokopo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate M-Pesa STK Push payments for a Kenyan e-commerce site?

M-Pesa STK Push integration automates customer payment collection by initiating prompts to users' phones and confirming transactions via webhook callbacks for reconciliation. This supports e-commerce checkout flows using configurable endpoints and OAuth 2.0 client credentials.

How do M-Pesa webhook callbacks work for payment reconciliation?

M-Pesa webhook callbacks automatically send transaction confirmation data to your configured endpoints once a customer completes an STK Push payment. This enables automated reconciliation by verifying payment success or failure without manual polling.

Can I automate merchant payouts and bank settlements via M-Pesa in Kenya?

Yes, you can automate merchant payouts and bank settlements via M-Pesa in Kenya. The integration supports disbursing funds to merchants or bank accounts with tracking references and automated failure handling for reliable settlement.

What OAuth 2.0 authentication do I need for a Kopokopo payments integration?

A Kopokopo payments integration requires OAuth 2.0 client credentials to authenticate API requests. You must configure your endpoints with these credentials to securely authorize STK Push flows, payouts, and bank settlements.

Does this M-Pesa payments integration handle failed transactions and disbursements?

Yes, this M-Pesa payments integration handles failed transactions and disbursements. It includes built-in failure handling for merchant payouts and settlements, using tracking references to monitor and manage unsuccessful bank transfers.