pesapal

Integrate Pesapal payments via OAuth2 Bearer authenticated API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrate Pesapal payments across East Africa via a single, OAuth2 Bearer authenticated API. Consolidate multiple channels (M-Pesa, Airtel Money, MTN Mobile Money, cards, and bank transfers) into one unified flow for Kenya, Uganda, Tanzania, and Rwanda.

Core Features & Use Cases

  • Unified payment flow: submit orders, obtain a redirect URL, and complete payments across multiple currencies (KES, UGX, TZS, RWF).
  • Real-time verification and notifications: verify transactions server-side and handle IPN/webhooks for reliable fulfillment.
  • Merchant integrations and multi-channel support: manage credentials, tokens, webhooks, and refunds in a single integration.

Quick Start

Register for Pesapal credentials, obtain an OAuth2 token, and start by submitting an order to receive a redirect URL.

Frequently Asked Questions about pesapal

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

FAQPage Schema
How do I integrate East African mobile money and card payments through a single API?

Integrate East African payments by submitting orders via an OAuth2 Bearer authenticated API to consolidate M-Pesa, Airtel Money, MTN Mobile Money, cards, and bank transfers into one unified payment flow.

What currencies are supported when processing cross-border payments in Kenya, Uganda, Tanzania, and Rwanda?

Processing cross-border payments supports multiple East African currencies, specifically handling KES, UGX, TZS, and RWF within the order submission and transaction verification flows.

How do I handle Pesapal webhooks and IPN notifications for reliable payment fulfillment?

Handle webhooks and IPN notifications by verifying transactions server-side to ensure reliable fulfillment, applying proper webhook verification and safe error handling during the transaction status check.

Do I need OAuth2 token management to submit orders and get a redirect URL for checkout?

Yes, you need OAuth2 token management to authenticate API requests, obtain a Bearer token, and successfully submit orders to receive a redirect URL for completing the checkout process.

Can I manage merchant credentials, tokens, and refunds across multiple East African payment channels in one integration?

Yes, merchant integrations allow you to manage credentials, tokens, webhooks, and refunds across multiple channels and countries within a single consolidated API integration.

Why does my transaction verification fail after redirecting customers back from the payment gateway?

Transaction verification fails when proper order IDs are not enforced or webhook verification is skipped, requiring server-side validation and strict IPN handling to confirm payment status safely.