{"id":265997,"date":"2025-12-27T19:49:28","date_gmt":"2025-12-27T19:49:28","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/melon\/"},"modified":"2025-12-29T21:37:00","modified_gmt":"2025-12-29T21:37:00","slug":"melon-payment-gateway","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/melon-payment-gateway\/","author":23411784,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"trunk","tested":"6.9.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Melon Payment Gateway for WooCommerce","header_author":"Adeleke","header_description":"Accept payments through Melon Wallet and Payment Gateway (Paga). Complete payment integration with OTP verification, wallet balance checking, and webhook support.","assets_banners_color":"","last_updated":"2025-12-29 21:37:00","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/getmelon.co","header_author_uri":"https:\/\/x.com\/Onlyleke","rating":0,"author_block_rating":0,"active_installs":0,"downloads":134,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0.0":"<p>Initial release of Melon Payment Gateway. Install and configure your API credentials to start accepting payments.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3428422,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3428418,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Payment method selection modal","2":"OTP verification modal","3":"Wallet balance display","4":"Admin settings page"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[252908,47710,6593,47156,286],"plugin_category":[45],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-265997","plugin","type-plugin","status-publish","hentry","plugin_tags-melon","plugin_tags-paga","plugin_tags-payment-gateway","plugin_tags-wallet","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_committers-getmelon"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/melon-payment-gateway\/assets\/icon-128x128.png?rev=3428422","icon_2x":"https:\/\/ps.w.org\/melon-payment-gateway\/assets\/icon-256x256.png?rev=3428418","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Melon Payment Gateway is a complete payment integration plugin that allows your store to accept payments through:<\/p>\n\n<ul>\n<li><strong>Melon Wallet<\/strong> - Direct wallet-to-wallet payments with OTP verification<\/li>\n<li><strong>Payment Gateway<\/strong> - Card and mobile money payments via Paga<\/li>\n<\/ul>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li>Complete payment flow with phone number validation<\/li>\n<li>OTP verification for secure transactions<\/li>\n<li>Melon wallet balance checking<\/li>\n<li>Support for both traditional and block-based checkout<\/li>\n<li>Real-time payment status updates<\/li>\n<li>Webhook support for payment confirmations<\/li>\n<li>Mobile-responsive payment modals<\/li>\n<li>Secure API integration with proper validation<\/li>\n<li>Payment reference tracking<\/li>\n<\/ul>\n\n<h4>Payment Flow<\/h4>\n\n<ol>\n<li>Customer enters phone number (Melon ID)<\/li>\n<li>System validates Melon ID via API<\/li>\n<li>OTP verification (if required)<\/li>\n<li>Payment method selection (Melon Wallet or Gateway)<\/li>\n<li>Payment processing and confirmation<\/li>\n<li>Order completion<\/li>\n<\/ol>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WooCommerce 5.0 or higher<\/li>\n<li>WordPress 5.8 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<li>Valid Melon API credentials<\/li>\n<\/ul>\n\n<h4>Getting Started<\/h4>\n\n<ol>\n<li>Install and activate the plugin<\/li>\n<li>Go to Settings &gt; Melon<\/li>\n<li>Enter your Melon API credentials:\n\n<ul>\n<li>Base URL<\/li>\n<li>Public Key<\/li>\n<li>Source<\/li>\n<li>Note: Origin is automatically detected from your WordPress site URL<\/li>\n<\/ul><\/li>\n<li>Enable the Melon payment gateway in Settings &gt; Payments<\/li>\n<li>Start accepting payments!<\/li>\n<\/ol>\n\n<h4>Support<\/h4>\n\n<p>For support, documentation, and updates, visit <a href=\"https:\/\/getmelon.co\">getmelon.co<\/a><\/p>\n\n<h3>Additional Information<\/h3>\n\n<h4>API Integration<\/h4>\n\n<p>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.<\/p>\n\n<h4>Webhook Configuration<\/h4>\n\n<p>The plugin automatically registers a webhook endpoint at <code>\/wp-json\/melon\/v1\/paga-webhook<\/code> for payment confirmations. No additional configuration is required for webhook functionality.<\/p>\n\n<h4>Custom Metadata<\/h4>\n\n<p>The plugin supports sending custom order metadata to the Melon API. Enable this feature in Settings &gt; Melon to send additional order information including customer details, billing and shipping addresses.<\/p>\n\n<h4>HPOS Compatibility<\/h4>\n\n<p>This plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS) and WooCommerce Blocks checkout, ensuring compatibility with the latest features.<\/p>\n\n<h4>Security<\/h4>\n\n<p>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.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin communicates with external services operated by Melon to provide payment processing functionality.<\/p>\n\n<h4>Melon Payment Infrastructure<\/h4>\n\n<p>The plugin integrates with the Melon payment infrastructure API (https:\/\/api.getmelon.co) to process payments, verify phone numbers, and handle transaction confirmations.<\/p>\n\n<p><strong>Why this service is required:<\/strong><\/p>\n\n<p>The Melon payment infrastructure is essential for processing payments through the Melon Wallet and Payment Gateway (Paga). Without this service, the plugin cannot function.<\/p>\n\n<p><strong>What data is sent:<\/strong><\/p>\n\n<ul>\n<li>Phone number (Melon ID) - Required for wallet verification and payment processing<\/li>\n<li>Order reference - Unique identifier for tracking transactions<\/li>\n<li>Payment amount - Transaction amount in the store's currency<\/li>\n<li>Payment metadata (optional) - Additional order information if custom metadata is enabled, including:\n\n<ul>\n<li>Order ID<\/li>\n<li>Customer name, email, and phone<\/li>\n<li>Billing and shipping addresses<\/li>\n<li>Product information<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p><strong>When data is sent:<\/strong><\/p>\n\n<ul>\n<li>During checkout - When customer initiates payment<\/li>\n<li>During payment verification - When OTP is verified<\/li>\n<li>During payment confirmation - When payment is processed<\/li>\n<li>During webhook callbacks - When payment status is updated<\/li>\n<\/ul>\n\n<p><strong>Who provides the service:<\/strong><\/p>\n\n<p>Melon (https:\/\/getmelon.co) provides the payment infrastructure and API services.<\/p>\n\n<p><strong>Service Links:<\/strong><\/p>\n\n<ul>\n<li>Terms of Service: https:\/\/getmelon.co\/terms<\/li>\n<li>Privacy Policy: https:\/\/getmelon.co\/privacy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Go to Plugins &gt; Add New<\/li>\n<li>Search for \"Melon Payment Gateway\"<\/li>\n<li>Click \"Install Now\"<\/li>\n<li>Activate the plugin<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin zip file<\/li>\n<li>Go to Plugins &gt; Add New &gt; Upload Plugin<\/li>\n<li>Choose the zip file and click \"Install Now\"<\/li>\n<li>Activate the plugin<\/li>\n<\/ol>\n\n<h4>Configuration<\/h4>\n\n<ol>\n<li>Navigate to Settings &gt; Melon<\/li>\n<li>Enter your Melon API credentials:\n\n<ul>\n<li>Base URL: Your Melon API base URL (e.g., https:\/\/staging-api.getmelon.co\/api\/v1)<\/li>\n<li>Public Key: Your Melon public key (format: pk_live_* or pk_test_*)<\/li>\n<li>Source: Source identifier (e.g., woocommerce)<\/li>\n<li>Note: Origin is automatically detected from your WordPress site URL (no manual configuration needed)<\/li>\n<\/ul><\/li>\n<li>Go to Settings &gt; Payments<\/li>\n<li>Enable and configure the Melon payment gateway<\/li>\n<li>Set the gateway title and description as desired<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='does%20this%20plugin%20work%20with%20woocommerce%20blocks%3F'><h3>Does this plugin work with WooCommerce Blocks?<\/h3><\/dt>\n<dd><p>Yes, the plugin is fully compatible with both traditional and block-based checkout.<\/p><\/dd>\n<dt id='what%20payment%20methods%20are%20supported%3F'><h3>What payment methods are supported?<\/h3><\/dt>\n<dd><p>The plugin supports two payment methods:\n* Melon Wallet - Direct wallet payments with OTP verification\n* Payment Gateway - Card and mobile money via Paga<\/p><\/dd>\n<dt id='is%20otp%20verification%20required%3F'><h3>Is OTP verification required?<\/h3><\/dt>\n<dd><p>OTP verification is required for new users or when the phone number is not validated. Validated Melon IDs skip OTP verification automatically.<\/p><\/dd>\n<dt id='how%20do%20i%20get%20my%20api%20credentials%3F'><h3>How do I get my API credentials?<\/h3><\/dt>\n<dd><p>Contact Melon support at <a href=\"https:\/\/getmelon.co\">getmelon.co<\/a> to obtain your API credentials.<\/p><\/dd>\n<dt id='does%20the%20plugin%20support%20webhooks%3F'><h3>Does the plugin support webhooks?<\/h3><\/dt>\n<dd><p>Yes, the plugin includes webhook support for payment confirmations from Paga. The webhook endpoint is available at: <code>\/wp-json\/melon\/v1\/paga-webhook<\/code><\/p><\/dd>\n<dt id='what%20happens%20if%20a%20user%20doesn%27t%20have%20a%20melon%20wallet%3F'><h3>What happens if a user doesn't have a Melon wallet?<\/h3><\/dt>\n<dd><p>If a user hasn't created a Melon wallet, the \"Pay with Melon\" option will be disabled and \"Pay with other options\" will be automatically selected.<\/p><\/dd>\n<dt id='is%20the%20plugin%20mobile%20responsive%3F'><h3>Is the plugin mobile responsive?<\/h3><\/dt>\n<dd><p>Yes, all payment modals are fully mobile responsive and optimized for mobile devices.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Melon Wallet payment integration<\/li>\n<li>Payment Gateway (Paga) integration<\/li>\n<li>OTP verification flow<\/li>\n<li>Wallet balance checking<\/li>\n<li>Webhook support<\/li>\n<li>Mobile-responsive modals<\/li>\n<li>WooCommerce Blocks compatibility<\/li>\n<li>Payment reference tracking<\/li>\n<li>Complete API integration with real-time reference ID<\/li>\n<\/ul>","raw_excerpt":"Accept payments through Melon Wallet and Payment Gateway (Paga) with complete OTP verification and wallet balance checking.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/265997","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=265997"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/getmelon"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=265997"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=265997"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=265997"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=265997"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=265997"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=265997"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}