README

Description

• This is a WooCommerce module developed by Optimist Hub team.
• After the integration you will be able to use pay with Moka POS automatically.
• You can easily integrate Moka United POS WooCommerce module into your e-commerce website and start receiving payment seamlessly and securely.
• With the open source code, you can make easily make new developments on your website.
• Moka United POS WooCommerce module supports SEO tools and is 100% compatible with Google.
• You can test your website in Sandbox, one of the best test environments.
• Moka United PAY WooCommerce module allows you to sell with installments on your website.
• Moka United PAY WooCommerce module is 100% compatible with WooCommerce and Wordpress systems.
• After the integration you can offer manually created orders and payment support to your customers.

ClientIP & ClientPort (Required)

TCMB regulation makes the end user ClientIP and ClientPort fields mandatory on every payment request. The plugin sends both automatically, with no configuration required on a standard server.

Behind a proxy, load balancer or CDN the connection is terminated by the intermediary, so the real customer address and port must be forwarded to PHP. Configure your edge to pass these headers:

# nginx
proxy_set_header X-Real-IP        $remote_addr;
proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Port $remote_port;

# Apache
RemoteIPHeader X-Forwarded-For

Cloudflare and most CDNs set CF-Connecting-IP / X-Forwarded-For automatically.

The plugin reads, in order:

• IP : CF-Connecting-IP -> True-Client-IP -> X-Real-IP -> X-Forwarded-For (first public address) -> Client-IP -> REMOTE_ADDR
• Port : X-Forwarded-Port -> X-Real-Port -> X-Client-Port -> REMOTE_PORT

Private, reserved and loopback addresses are discarded, because Moka rejects them. If your infrastructure uses custom header names, override the detection:

add_filter('optimisthub_moka_client_ip', fn() => $_SERVER['HTTP_X_MY_CLIENT_IP'] ?? null);
add_filter('optimisthub_moka_client_port', fn() => $_SERVER['HTTP_X_MY_CLIENT_PORT'] ?? null);

Since recurring subscription payments run from cron with no visitor connection, the original ClientIP / ClientPort captured on the first payment are reused for renewals.

Requirements & Release Notes

Moka United Pos, Moka United Pay plugin;

• Minimum PHP 7.4+ requirement is required.
• PHP cURL extension is required.
• Tried with MYSQL 5.7.43, 8.0.
• Tested with PHP versions 7.4, 8.1.
• Fully compatible with WooCommerce version 6.0+.
• Fully compatible with WordPress 5.8.2+.

How To Install

• Moka United Pay WooCommerce Plugin Download ZIP file and then Install with wordpress extension installer page.

Test Cards

For sandbox usage : https://developer.mokaunited.com/home.php?page=test-kartlari

Changelog

Version history : https://github.com/optimisthub/moka-woocommerce/wiki/Changelog

Filters & Actions

Filters & Actions : https://github.com/optimisthub/moka-woocommerce/wiki/Filters-&-Actions

Other integrations

• Moka United PHP Client : https://github.com/optimisthub/moka-php
• Moka United OpenCart 3.x : https://github.com/optimisthub/moka-opencart-3.x
• Moka United OpenCart 2.3x : https://github.com/optimisthub/moka-opencart-2.3
• Moka United OpenCart 2.2x : https://github.com/optimisthub/moka-opencart-2.2
• Moka United Presta Shop : https://github.com/optimisthub/moka-prestashop
• Moka United Magento : https://github.com/optimisthub/moka-magento

Powerfull WordPress Plugins by Optimisthub

• Smart SEO Friendly Sitemap Generator [Already Published] : https://github.com/optimisthub/smart-sitemap-generator
• Scheduled Posts Issue Fixer : https://github.com/optimisthub/scheduled-posts-issue-fixer
• Enable Svg Support : https://github.com/optimisthub/wordpress-svg-enabler