Overview
Welcome to the keshflippay Developer Documentation
The keshflippay Partner API provides unified access to both crypto and fiat payment infrastructure across Africa and beyond.
Introduction
keshflippay enables developers and businesses to integrate payments, settlements, and value transfers across traditional and blockchain-based systems using a single, consistent API.
With keshflippay, you can:
- Build wallets that hold both crypto and fiat balances.
- Accept and send payments through mobile money or bank transfers.
- Enable crypto on/off ramps with transparent exchange rates.
- Automate transaction processing and reconciliation through webhooks.
- Use official SDKs for JavaScript and Python for faster integration.
The platform is designed with security, compliance, and developer simplicity as core principles.
System Architecture
The keshflippay platform is composed of several API modules, each designed to handle a specific aspect of payment processing:
| Module | Description |
|---|---|
| Authentication | Secure API key management and HMAC-based request signing. |
| Crypto API | Manage on-chain assets, transfers, and wallet operations. |
| Fiat API | Handle fiat payments, conversions, and settlements. |
| Webhooks | Receive real-time updates about payment events and balances. |
| SDKs | Simplify integration through official client libraries. |
All endpoints use HTTPS and return JSON responses. Requests are authenticated and signed using HMAC-SHA256 to ensure integrity.
Security
Security is enforced at every layer of the API.
All requests require three headers:
| Header | Description |
|---|---|
X-keshflippay-Key | Your public API key. |
X-keshflippay-Timestamp | Current Unix timestamp (in seconds). |
X-keshflippay-Signature | HMAC-SHA256 signature generated with your secret key. |
Detailed examples of signing requests and verifying signatures can be found in the Authentication & Security section.
Supported Use Cases
keshflippay supports a variety of use cases, including:
- Payment gateways integrating crypto and fiat methods.
- Wallet services providing digital asset management.
- Fintech platforms offering verified payment accounts.
- Automated systems reacting to real-time payment events.
These use cases are supported by RESTful APIs and event-driven integrations.
Integration Flow
A typical integration follows these steps:
- Authenticate using your API keys.
- Create or link customer wallets and accounts.
- Initiate payments via the Crypto or Fiat APIs.
- Monitor transactions using Webhooks.
- Handle errors using standardized response codes.
A detailed guide is available in Getting Started.
SDKs and Tools
| SDK | Repository | Documentation |
|---|---|---|
| JavaScript / TypeScript | GitHub → | JavaScript SDK |
| Python | GitHub → | Python SDK |
Each SDK provides built-in methods for authentication, request signing, and error handling.
Developer Resources
- Sandbox environment for testing integrations.
- Comprehensive API reference for all endpoints.
- Error catalog with response code definitions.
- Frequently Asked Questions and Glossary for quick reference.
Explore the API Reference
or begin implementation with the Getting Started guide.
Community and Support
For assistance, integration feedback, or business inquiries:
- Email: support@keshflippay.com
- Facebook: Follow us
- Instagram: Follow us
- Twitter: Follow us
- GitHub: keshflippay Repositories