Medusa Payment iPay
iPay Africa payment provider for Medusa v2, supporting multiple payment channels including M-Pesa, Airtel Money, credit/debit cards, and PesaLink.
Features
- M-Pesa Integration: Accept payments via M-Pesa mobile money
- Airtel Money: Support for Airtel Money payments
- Card Payments: Process credit and debit card transactions
- PesaLink: Bank transfer support via PesaLink
- Webhook Support: Real-time payment notifications
- East Africa Focus: Optimized for Kenya and East African markets
Supported Payment Methods
- M-Pesa - Kenya’s leading mobile money platform
- Airtel Money - Mobile money payments
- Credit/Debit Cards - Visa, Mastercard, and other cards
- PesaLink - Instant bank transfers
Requirements
- Medusa v2
- Active iPay Africa merchant account
Installation
npm install medusa-payment-ipay
Configuration
Configure the plugin with environment variables and admin setup:
Environment Variables
Set up your iPay Africa credentials in your environment file.
Test Credentials
- Vendor ID: “demo” (for sandbox testing)
Payment Flow
The plugin handles the complete payment flow including:
- Payment initiation
- Payment processing
- Webhook notifications
- Payment confirmation
Webhook Endpoint
Configure webhook endpoints in your iPay Africa dashboard to receive real-time payment notifications.
Production Deployment
Before going live:
- Test thoroughly in sandbox mode
- Configure production credentials
- Set up webhook endpoints
- Ensure PCI compliance for card payments
Important Notes
- Sandbox Testing: Always test in sandbox mode before production
- PCI Compliance: Maintain PCI compliance for card payment processing
- Webhook Security: Secure your webhook endpoints