Overview
Start collecting payments, sending payouts, and handling webhooks with Genuka Pay.
Introduction
Genuka Pay is a payment infrastructure layer for collecting funds, sending payouts, and operating compliant money flows across supported African markets.
This documentation is written around the way teams actually ship:
- connect your application
- authenticate requests
- create a payment or payout flow
- listen for asynchronous webhook events
- complete KYC and prepare for production
Get Started
Understand the integration flow, authenticate your app, and launch your first request.
Payments and Payouts
Explore the API surface for collections, disbursements, transaction tracking, and callbacks.
Operational Guides
Learn how to manage credentials, configure test mode, and handle operational concerns safely.
KYC and Go Live
Review onboarding, activation requirements, and the controls needed before moving to production.
New to Genuka Pay?
Start with the Getting Started guide, then continue with Quick Start and Authentication.
Core Concepts
Payments: Use Genuka Pay to initiate collections and track their lifecycle from your backend.
Payouts: Send funds to recipients through supported payout rails with a consistent API flow.
Webhooks: Receive asynchronous updates for status changes instead of polling every operation.
KYC: Complete account verification and compliance checks before requesting production usage.
Recommended Path
If you are integrating for the first time, follow this order:
- Read Overview
- Complete Quick Start
- Configure Authentication
- Review the API Overview
- Configure Webhooks
- Finish Account Activation and KYC
Documentation Map
Getting Started
Overview
High-level introduction to the Genuka Pay integration flow.
Quick Start
Get your first integration path running with the minimum required setup.
Authentication
Learn how to authenticate requests securely with your API credentials.
API Reference
API Overview
Understand the main resources, request patterns, and response conventions.
Payments
Build collection flows and monitor payment execution.
Payouts
Send funds to recipients and manage payout operations.
Webhooks
Process delivery events and keep your integration in sync.
Operational Guides
Payment Methods
Configure and manage your mobile money payment methods to receive funds.
Manage API Keys
Protect, rotate, and separate your credentials properly.
Supported Regions and Currencies
Review the geographic and currency constraints of your integration.
Test Mode
Validate flows before exposing real transactions to users.
Error Handling
Design resilient integrations that fail safely and transparently.
Security Best Practices
Apply the minimum security controls expected for payment infrastructure.
Account Activation and KYC
Understand the operational and compliance requirements for production access.
Before You Go Live
Use this checklist before enabling production traffic:
- your company profile is complete
- your KYC submission has been approved
- your secret key is stored server-side only
- your webhook endpoint is configured and verified
- your integration has been tested in low-risk conditions
- your error handling and retry logic have been reviewed
Conventions Used In These Docs
{{BASE_URL}}refers to your deployed Genuka Pay API base URL- authenticated requests use HMAC headers
- amounts should always be sent with an explicit ISO currency code such as
XAForXOF - webhook-driven updates should be treated as the source of truth for async status changes
FAQ
How is this guide?
Last updated on