Plugin renamed for WordPress.org trademark compliance; internal identifiers were also namespaced, including the payment-request storage. Existing payment-request records from prior versions will no longer appear in the admin list after upgrading (the data is retained in the database, just under the old internal type). Your gateway settings, orders, and webhook URL are unaffected - only the underlying payment-request tracking records are affected.<\/p>","2.1.0":"
Plugin renamed to TK MPesa Payment Gateway (new slug). If upgrading from a manual install: activate this version first, confirm your settings and orders still show correctly, then remove the old copy. Don't delete either copy until migration is confirmed.<\/p>","2.0.0":"
Security and compatibility update. Adds WooCommerce Blocks support and HPOS compatibility. Fully backward compatible \u2014 existing settings, orders, and webhook URLs are unchanged.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3666617,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3666617,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3666617,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3666617,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3666617,"resolution":"1","location":"assets","locale":"","width":1696,"height":351},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3666617,"resolution":"10","location":"assets","locale":"","width":1602,"height":253},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3666617,"resolution":"11","location":"assets","locale":"","width":488,"height":159},"screenshot-12.png":{"filename":"screenshot-12.png","revision":3666617,"resolution":"12","location":"assets","locale":"","width":1642,"height":352},"screenshot-13.png":{"filename":"screenshot-13.png","revision":3666617,"resolution":"13","location":"assets","locale":"","width":1522,"height":355},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3666617,"resolution":"2","location":"assets","locale":"","width":1685,"height":1698},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3666617,"resolution":"3","location":"assets","locale":"","width":1144,"height":285},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3666617,"resolution":"4","location":"assets","locale":"","width":1570,"height":130},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3666617,"resolution":"5","location":"assets","locale":"","width":608,"height":545},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3666617,"resolution":"6","location":"assets","locale":"","width":1047,"height":709},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3666617,"resolution":"7","location":"assets","locale":"","width":1485,"height":209},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3666617,"resolution":"8","location":"assets","locale":"","width":1249,"height":649},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3666617,"resolution":"9","location":"assets","locale":"","width":1614,"height":219}},"screenshots":{"1":"The MPesa Gateway listed on the WooCommerce Payments settings screen","2":"The gateway configuration screen - credentials, Paybill\/Till setup, and callback URL","3":"Selecting the payment type - Paybill or Buy Goods Till","4":"The gateway enabled and ready to accept payments","5":"What the customer sees at checkout - MPesa Payments selected, prompting for their phone number","6":"The customer-facing \"Pay for order\" screen for retrying or completing payment on an existing order","7":"A completed MPesa order in the WooCommerce Orders list","8":"Order detail showing the MPesa payment confirmation and the customer's billed MPesa number","9":"The plugin on the WordPress Plugins screen, ready to activate","10":"The plugin active, with donation links on the Plugins screen","11":"The MPesa Payments admin menu, with a dedicated Logs submenu","12":"Payment request tracking - every STK Push request logged with its status","13":"Diagnostic logs under WooCommerce \u2192 Status \u2192 Logs (source TK MPesa Payment Gateway allows your WooCommerce customers to pay directly from their mobile phone via MPesa STK Push (Lipa Na MPesa Online).<\/p>\n\n This plugin is not affiliated with, endorsed by, or sponsored by Safaricom PLC. M-Pesa and Daraja are trademarks of Safaricom PLC, referenced here only to describe compatibility with their payment service.<\/p>\n\n How it works:<\/strong><\/p>\n\n If a customer doesn't complete the prompt in time or the order is otherwise left unpaid, they can return to it later through WooCommerce's standard \"Pay for order\" screen to retry.<\/p>\n\n Payment types:<\/strong><\/p>\n\n Checkout compatibility:<\/strong><\/p>\n\n Payment tracking & admin tools:<\/strong><\/p>\n\n Sandbox \/ test mode:<\/strong><\/p>\n\n Security:<\/strong><\/p>\n\n Requirements:<\/strong><\/p>\n\n This plugin connects to the Safaricom Daraja API to process M-Pesa payments. This is required for the plugin's core function - initiating an M-Pesa STK Push payment request to the customer's phone and receiving confirmation that it was paid.<\/p>\n\n Two Daraja endpoints are used:<\/p>\n\n This plugin is not affiliated with, endorsed by, or sponsored by Safaricom PLC. Learn more: Daraja API Terms and Conditions<\/a>, Safaricom Data Privacy Statement<\/a>.<\/p>\n\n\n Uploading and activating<\/strong><\/p>\n\n Configuring the gateway<\/strong><\/p>\n\n Getting MPesa credentials<\/strong><\/p>\n\n Managing your credentials later<\/strong><\/p>\n\n Return to WooCommerce \u2192 Settings \u2192 Payments \u2192 MPesa Gateway<\/strong> any time to update your credentials, for example after Safaricom issues new keys or when moving from sandbox to live. Existing orders and payment history are unaffected by a credentials change. The Test mode<\/strong> checkbox switches between the Safaricom sandbox and live production API - make sure the credentials you've entered match whichever mode is enabled, since sandbox keys will not work in live mode and vice versa.<\/p>\n\n Viewing logs<\/strong><\/p>\n\n If a payment doesn't go through, check MPesa Payments \u2192 Logs<\/strong> in your WordPress admin menu (or WooCommerce \u2192 Status \u2192 Logs<\/strong>, source Yes. Version 2.0.0 and above fully supports the WooCommerce Checkout Block via the Yes. Enable Test mode<\/strong> in the gateway settings to use the Safaricom Daraja sandbox API. Use sandbox credentials from the Daraja portal.<\/p><\/dd>\n Safaricom's systems block callback URLs containing the word \"mpesa\" as a security measure.<\/p><\/dd>\n Yes. No card data is handled. All payment data flows directly between the customer's phone and Safaricom's servers. The plugin only initiates an STK Push request and receives a callback confirmation.<\/p><\/dd>\n\n<\/dl>\n\n\ntk-mpesa<\/code>)"}},"plugin_section":[],"plugin_tags":[37731,3050,507,277553,286],"plugin_category":[45],"plugin_contributors":[273955],"plugin_business_model":[],"class_list":["post-358434","plugin","type-plugin","status-publish","hentry","plugin_tags-kenya","plugin_tags-mpesa","plugin_tags-payment","plugin_tags-safaricom","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-tkiguta","plugin_committers-tkiguta"],"banners":{"banner":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/banner-772x250.png?rev=3666617","banner_2x":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/banner-1544x500.png?rev=3666617","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/icon-128x128.png?rev=3666617","icon_2x":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/icon-256x256.png?rev=3666617","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-1.png?rev=3666617","caption":"The MPesa Gateway listed on the WooCommerce Payments settings screen"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-2.png?rev=3666617","caption":"The gateway configuration screen - credentials, Paybill\/Till setup, and callback URL"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-3.png?rev=3666617","caption":"Selecting the payment type - Paybill or Buy Goods Till"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-4.png?rev=3666617","caption":"The gateway enabled and ready to accept payments"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-5.png?rev=3666617","caption":"What the customer sees at checkout - MPesa Payments selected, prompting for their phone number"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-6.png?rev=3666617","caption":"The customer-facing \"Pay for order\" screen for retrying or completing payment on an existing order"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-7.png?rev=3666617","caption":"A completed MPesa order in the WooCommerce Orders list"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-8.png?rev=3666617","caption":"Order detail showing the MPesa payment confirmation and the customer's billed MPesa number"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-9.png?rev=3666617","caption":"The plugin on the WordPress Plugins screen, ready to activate"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-10.png?rev=3666617","caption":"The plugin active, with donation links on the Plugins screen"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-11.png?rev=3666617","caption":"The MPesa Payments admin menu, with a dedicated Logs submenu"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-12.png?rev=3666617","caption":"Payment request tracking - every STK Push request logged with its status"},{"src":"https:\/\/ps.w.org\/tk-paybill-and-till-checkout-for-mpesa\/assets\/screenshot-13.png?rev=3666617","caption":"Diagnostic logs under WooCommerce \u2192 Status \u2192 Logs (source tk-mpesa<\/code>)"}],"raw_content":"\n\n
stkpush\/v1\/processrequest<\/code>) request for the order total.<\/li>\n\n
CustomerPayBillOnline<\/code>) - pay into a Paybill number and account<\/li>\nCustomerBuyGoodsOnline<\/code>) - pay into a Till number; the Till must be settling funds to a bank account<\/li>\n\n
AbstractPaymentMethodType<\/code> integration<\/li>\n\n
tk-mpesa<\/code>), useful when a payment doesn't go through<\/li>\n\n
\n
==<\/code><\/li>\n\n
External services<\/h3>\n\n
\n
oauth\/v1\/generate<\/code> - authenticates the site with Safaricom using the Consumer Key and Consumer Secret you enter in the gateway settings. No customer data is sent to this endpoint.<\/li>\nmpesa\/stkpush\/v1\/processrequest<\/code> - initiates the STK Push. When a customer places an order and chooses this payment method at checkout, the following is sent: your configured Paybill\/Till short code, the order amount, the customer's phone number, a callback URL, and the WooCommerce order ID (as a reference). Safaricom then sends a payment-result callback to this site's REST endpoint.<\/li>\n<\/ul>\n\n\n
tk-paybill-and-till-checkout-for-mpesa<\/code> folder to \/wp-content\/plugins\/<\/code> via FTP\/SFTP).<\/li>\n\n
abc123xyz<\/code>), not your website's URL. No spaces, and it must not contain the word \"mpesa\". The plugin builds the full callback link for you automatically.<\/li>\n\n
tk-mpesa<\/code>) for the exact error Safaricom's API returned.<\/p>\n\n\n\n
Does this work with the WooCommerce Checkout Block?<\/h3><\/dt>\n
AbstractPaymentMethodType<\/code> integration.<\/p><\/dd>\nCan I test without going live?<\/h3><\/dt>\n
Why must my callback URL not contain \"mpesa\"?<\/h3><\/dt>\n
Is this plugin PCI DSS compliant?<\/h3><\/dt>\n
2.2.0<\/h4>\n\n
\n
==<\/code><\/li>\n<\/ul>\n\n2.1.0<\/h4>\n\n
\n
uninstall.php<\/code> to clean up gateway settings and payment-request records on deletion<\/li>\nload_plugin_textdomain()<\/code> call<\/li>\n2.0.0<\/h4>\n\n
\n
permission_callback<\/code> on REST callback endpoint<\/li>\nparse_tel()<\/code> phone normalisation using regex (replaced broken ltrim()<\/code>)<\/li>\ndate()<\/code> replaced with gmdate()<\/code> for timezone correctness<\/li>\n1.0.0<\/h4>\n\n
\n