Melon Payment Gateway for WooCommerce
Melon Payment Gateway is a complete payment integration plugin that allows your store to accept payments through:
- Melon Wallet — Direct wallet-to-wallet payments with OTP verification
- Payment Gateway — Card and mobile money payments via Paga
Key Features
- Complete payment flow with phone number validation
- OTP verification for secure transactions
- Melon wallet balance checking
- Support for both traditional and block-based checkout
- Real-time payment status updates
- Webhook support for payment confirmations
- Mobile-responsive payment modals
- Secure API integration with proper validation
- Payment reference tracking
Payment Flow
- Customer enters phone number (Melon ID)
- System validates Melon ID via API
- OTP verification (if required)
- Payment method selection (Melon Wallet or Gateway)
- Payment processing and confirmation
- Order completion
Requirements
- WooCommerce 5.0 or higher
- WordPress 5.8 or higher
- PHP 7.4 or higher
- Valid Melon API credentials
Getting Started
- Install and activate the plugin
- Go to Settings > Melon
- Enter your Melon API credentials:
- Base URL
- Public Key
- Source
- Note: Origin is automatically detected from your WordPress site URL
- Enable the Melon payment gateway in Settings > Payments
- Start accepting payments!
Support
For support, documentation, and updates, visit getmelon.co
Additional Information
API Integration
The plugin integrates with the Melon API to provide secure payment processing. All API communications are encrypted and validated. The plugin supports both staging and production environments.
Webhook Configuration
The plugin automatically registers a webhook endpoint at /wp-json/melon/v1/paga-webhook for payment confirmations. No additional configuration is required for webhook functionality.
Custom Metadata
The plugin supports sending custom order metadata to the Melon API. Enable this feature in Settings > Melon to send additional order information including customer details, billing and shipping addresses.
HPOS Compatibility
This plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS) and WooCommerce Blocks checkout, ensuring compatibility with the latest features.
Security
All user inputs are sanitized and validated. API credentials are stored securely in the WordPress database. The plugin follows WordPress coding standards and security best practices.
External Services
This plugin communicates with external services operated by Melon to provide payment processing functionality.
Melon Payment Infrastructure
The plugin integrates with the Melon payment infrastructure API (https://api.getmelon.co) to process payments, verify phone numbers, and handle transaction confirmations.
Why this service is required:
The Melon payment infrastructure is essential for processing payments through the Melon Wallet and Payment Gateway (Paga). Without this service, the plugin cannot function.
What data is sent:
- Phone number (Melon ID) — Required for wallet verification and payment processing
- Order reference — Unique identifier for tracking transactions
- Payment amount — Transaction amount in the store’s currency
- Payment metadata (optional) — Additional order information if custom metadata is enabled, including:
- Order ID
- Customer name, email, and phone
- Billing and shipping addresses
- Product information
When data is sent:
- During checkout — When customer initiates payment
- During payment verification — When OTP is verified
- During payment confirmation — When payment is processed
- During webhook callbacks — When payment status is updated
Who provides the service:
Melon (https://getmelon.co) provides the payment infrastructure and API services.
Service Links:
- Terms of Service: https://getmelon.co/terms
- Privacy Policy: https://getmelon.co/privacy