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.