{"id":382096,"date":"2026-10-27T05:19:01","date_gmt":"2026-10-27T05:19:01","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/buynow\/"},"modified":"2026-10-28T05:18:13","modified_gmt":"2026-10-28T05:18:13","slug":"buy-now-by-kib","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/buy-now-by-kib\/","author":23575610,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"3.0.65","stable_tag":"3.0.65","tested":"7.1.4","requires":"6.0","requires_php":"8.1","requires_plugins":null,"header_name":"Buy Now by KIB","header_author":"Kuwait International Bank","header_description":"BuyNow Split and Financing for WooCommerce, powered by KIB.","assets_banners_color":"","last_updated":"2026-10-28 05:18:13","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/www.kib.com.kw","rating":0,"author_block_rating":0,"active_installs":0,"downloads":79,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"3.0.65":{"tag":"3.0.65","author":"kibbank","date":"2026-10-28 05:18:13","revision":3769948}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3767837,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3767837,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["3.0.65"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3767813,"resolution":"1","location":"assets","locale":"","width":720,"height":540},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3767813,"resolution":"2","location":"assets","locale":"","width":698,"height":310},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3767813,"resolution":"3","location":"assets","locale":"","width":720,"height":432},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3767813,"resolution":"4","location":"assets","locale":"","width":698,"height":367},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3767813,"resolution":"5","location":"assets","locale":"","width":622,"height":552},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3767813,"resolution":"6","location":"assets","locale":"","width":522,"height":300}},"screenshots":{"1":"Environments: enter your BuyNow credentials for UAT or Live and test the connection.","2":"Portal Setup: copy the webhook URL, redirect URL, and webhook auth header into the BuyNow portal.","3":"Store Settings: enable BuyNow, choose the payment mode, and set the maximum financing tenor.","4":"Store Settings: set the Split down payment and choose where the instalment amount is shown.","5":"Order Settings: map BuyNow statuses to WooCommerce order statuses.","6":"Checkout: BuyNow Financing in the payment methods, with the tenor selector."}},"plugin_section":[],"plugin_tags":[193715,31366,130590,6593,286],"plugin_category":[45],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-382096","plugin","type-plugin","status-publish","hentry","plugin_tags-bnpl","plugin_tags-financing","plugin_tags-kuwait","plugin_tags-payment-gateway","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_committers-kibbank"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/icon-128x128.png?rev=3767837","icon_2x":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/icon-256x256.png?rev=3767837","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-1.png?rev=3767813","caption":"Environments: enter your BuyNow credentials for UAT or Live and test the connection."},{"src":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-2.png?rev=3767813","caption":"Portal Setup: copy the webhook URL, redirect URL, and webhook auth header into the BuyNow portal."},{"src":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-3.png?rev=3767813","caption":"Store Settings: enable BuyNow, choose the payment mode, and set the maximum financing tenor."},{"src":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-4.png?rev=3767813","caption":"Store Settings: set the Split down payment and choose where the instalment amount is shown."},{"src":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-5.png?rev=3767813","caption":"Order Settings: map BuyNow statuses to WooCommerce order statuses."},{"src":"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-6.png?rev=3767813","caption":"Checkout: BuyNow Financing in the payment methods, with the tenor selector."}],"raw_content":"<!--section=description-->\n<p>BuyNow lets WooCommerce customers pay with KIB BuyNow flexible payment options:<\/p>\n\n<ul>\n<li>Split \u2013 split the order total into instalments.<\/li>\n<li>Financing \u2013 apply for Sharia-compliant financing at checkout.<\/li>\n<\/ul>\n\n<p>Features:<\/p>\n\n<ul>\n<li>Classic and block-based checkout support.<\/li>\n<li>Sandbox and Production environments with a credential test before going live.<\/li>\n<li>Signed webhooks to keep order statuses in sync.<\/li>\n<li>HPOS (High-Performance Order Storage) compatible.<\/li>\n<li>English and Arabic interface.<\/li>\n<\/ul>\n\n<h4>External services<\/h4>\n\n<p>This plugin connects to the KIB BuyNow payment gateway (hosted at buynow.kib.com.kw and related KIB environments) to authenticate the merchant, create finance applications and orders, and retrieve their status. This is required for BuyNow Split and Financing checkout.<\/p>\n\n<p>Data sent when a customer places an order with BuyNow: order amount, customer phone number (the mobile number entered at checkout for Split, or the billing phone for Financing), order ID (correlation ID), number of instalments or financing tenor, and order line items (product ID, name, price, and quantity). Merchant credentials (merchant reference, API key, and a request signature) are sent when authenticating. Requests happen only at checkout, when checking order status, and when an administrator tests credentials.<\/p>\n\n<p>The gateway also sends webhook notifications to your store to update order statuses.<\/p>\n\n<p>This service is provided by Kuwait International Bank (KIB): <a href=\"https:\/\/www.kib.com.kw\/dam\/jcr:2a1bc1f0-026c-42dc-869a-9dc225f736b9\/terms-and-conditions-online-banking.pdf\">terms of use<\/a>, <a href=\"https:\/\/www.kib.com.kw\/en\/home\/Personal\/Bank\/ways-to-Bank\/KIB-Mobile\/Privacy-Policy.html\">privacy policy<\/a>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>buy-now-by-kib<\/code> folder to <code>\/wp-content\/plugins\/<\/code> or install the plugin ZIP from Plugins \u2192 Add New.<\/li>\n<li>Activate the plugin. WooCommerce must be active.<\/li>\n<li>Go to WooCommerce \u2192 Settings \u2192 Payments \u2192 BuyNow.<\/li>\n<\/ol>\n\n<h4>Step 1: Connect your BuyNow account (Environments tab)<\/h4>\n\n<ol>\n<li>Select the UAT environment to test first. The environment marked \"In Use\" is the one checkout uses.<\/li>\n<li>Under Credentials, enter the Merchant Reference (UUID), API Key, and HMAC Secret from the BuyNow portal.<\/li>\n<li>Click Save changes, then click Test Connection. \"Connection successful.\" confirms the credentials are valid.<\/li>\n<\/ol>\n\n<p>See <a href=\"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-1.png\">screenshot 1<\/a>, also shown in the Screenshots section of the Details tab.<\/p>\n\n<h4>Step 2: Register your store in the BuyNow portal (Portal Setup)<\/h4>\n\n<ol>\n<li>Use the copy buttons in Portal Setup to copy the Webhook URL, Redirect URL, Webhook Auth Header Key, and Webhook Auth Header Value.<\/li>\n<li>Paste each value into the matching field in the BuyNow portal. BuyNow uses the webhook to update order statuses and the redirect URL to send customers back to your store.<\/li>\n<li>Click Regenerate only if you need a new header value. You must then update it in the BuyNow portal as well.<\/li>\n<\/ol>\n\n<p>See <a href=\"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-2.png\">screenshot 2<\/a>.<\/p>\n\n<h4>Step 3: Choose how BuyNow is offered (Store Settings tab)<\/h4>\n\n<ol>\n<li>Turn on Enable BuyNow.<\/li>\n<li>Choose a Payment Mode: Split Only (orders up to 500 KWD), Financing Only (orders above 500 KWD up to 25,000 KWD), or Both (Split up to 500 KWD, Financing above that up to 25,000 KWD).<\/li>\n<li>Set Financing Max Tenor. Customers can choose any tenor from 3 months up to this limit (maximum 60 months).<\/li>\n<li>Set the Split Down Payment Percentage. The preview below the field shows what customers will see.<\/li>\n<li>Under Show BuyNow On, choose where to display the instalment amount: product page, shop and category pages, related products, cart page, or mini cart.<\/li>\n<li>Click Save changes.<\/li>\n<\/ol>\n\n<p>These settings apply to every environment. See <a href=\"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-3.png\">screenshot 3<\/a> and <a href=\"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-4.png\">screenshot 4<\/a>.<\/p>\n\n<h4>Step 4: Map order statuses (Order Settings tab)<\/h4>\n\n<p>Each BuyNow status is mapped to a WooCommerce order status for Split and Financing. The defaults work for most stores. Change a dropdown if your fulfilment process needs a different status, then click Save changes.<\/p>\n\n<p>See <a href=\"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-5.png\">screenshot 5<\/a>.<\/p>\n\n<h4>Step 5: Test and go live<\/h4>\n\n<ol>\n<li>With UAT in use, place a test order and choose BuyNow at checkout (<a href=\"https:\/\/ps.w.org\/buy-now-by-kib\/assets\/screenshot-6.png\">screenshot 6<\/a>). Confirm that you are redirected to BuyNow, returned to your store, and that the order status updates.<\/li>\n<li>Select the Live environment, enter your production credentials, click Save changes, then click Test Connection.<\/li>\n<li>Copy the Live Portal Setup values into the production BuyNow portal.<\/li>\n<li>Click Go Live. This is only possible after the Live credentials are saved and tested successfully.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"which%20currency%20is%20supported%3F\"><h3>Which currency is supported?<\/h3><\/dt>\n<dd><p>BuyNow is only offered at checkout when the store currency matches the currency supported by the gateway.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20the%20block%20checkout%3F\"><h3>Does it work with the block checkout?<\/h3><\/dt>\n<dd><p>Yes. Both the classic shortcode checkout and the WooCommerce Checkout block are supported.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>3.0.65<\/h4>\n\n<ul>\n<li>Escape settings, order, and return-page output when it is printed.<\/li>\n<li>Remove the development editor folder from the plugin package.<\/li>\n<\/ul>\n\n<h4>3.0.64<\/h4>\n\n<ul>\n<li>Offer Financing only above 500 KWD through 25,000 KWD, and hide it outside that range.<\/li>\n<\/ul>\n\n<h4>3.0.63<\/h4>\n\n<ul>\n<li>Hide BuyNow at checkout when the order total is outside the active payment mode: Split up to 500 KWD, Financing up to 25,000 KWD, and both modes split at the threshold.<\/li>\n<\/ul>\n\n<h4>3.0.62<\/h4>\n\n<ul>\n<li>Rename plugin display name to Buy Now by KIB, folder and text domain slug to buy-now-by-kib.<\/li>\n<\/ul>\n\n<h4>3.0.61<\/h4>\n\n<ul>\n<li>Document KIB terms of use and privacy policy links for the external gateway.<\/li>\n<li>Escape installment learn-more markup on product pages.<\/li>\n<li>Remove unclosed frontend output buffering used for public tunnel URL rewrites.<\/li>\n<li>Align Stable Tag with the plugin version and drop discouraged textdomain loading.<\/li>\n<\/ul>\n\n<h4>3.0.60<\/h4>\n\n<ul>\n<li>Verify the BuyNow return signature and show success, failed, or not found.<\/li>\n<\/ul>\n\n<h4>3.0.59<\/h4>\n\n<ul>\n<li>Center the return-page message.<\/li>\n<\/ul>\n\n<h4>3.0.58<\/h4>\n\n<ul>\n<li>Show the webhook URL as a read-only portal value.<\/li>\n<\/ul>\n\n<h4>3.0.57<\/h4>\n\n<ul>\n<li>Plugin Check compliance fixes.<\/li>\n<\/ul>","raw_excerpt":"BuyNow Split and Financing for WooCommerce, powered by KIB.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/382096","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=382096"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kibbank"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=382096"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=382096"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=382096"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=382096"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=382096"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=382096"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}