=== Plugin Name === Contributors: bananacrystal Donate link: https://www.bananacrystal.com/ Tags: payments, bananacrystal, woocommerce, payment gateway Requires at least: 6.2 Requires PHP: 7.4 Tested up to: 7.1 Stable tag: 1.3.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Accept WooCommerce payments with BananaCrystal — now with AI Agent mode for the new BananaCrystal platform, alongside the classic setup. == Description == **Accept payments for your store or business almost free with [BananaCrystal](https://www.bananacrystal.com)** ![BananaCrystal Payment Gateway Plugin](https://media.bananacrystal.com/wp-content/uploads/2020/12/30060859/cropped-bananacrystal-logo-400x100-1-1.png "BananaCrystal Logo") **Now with AI Agent mode.** Connect your WooCommerce store to the new BananaCrystal AI agent payment platform (agents.bananacrystal.com), so payments settle straight into your store's agent wallet. Shoppers pay on a hosted BananaCrystal page and return to your store, and the order is confirmed automatically. ## WHAT'S NEW * **AI Agent mode:** connect a store on the new BananaCrystal (agents.bananacrystal.com). Shoppers pay on a hosted BananaCrystal page and return to your store, and the order is confirmed automatically. Pick your mode in the gateway settings; the existing (legacy) setup keeps working. * **Block checkout support:** the gateway now shows on the WooCommerce Checkout and Cart blocks, not just the classic checkout. * **Tested with the latest WooCommerce**, including High-Performance Order Storage (HPOS). ## AI Agent mode For stores on the new BananaCrystal (agents.bananacrystal.com). Add a WooCommerce integration, paste the order completion / thank-you, order pay / return, and payment notifications URLs shown in the gateway settings, then paste your publishable key (starts with pk_live_). Shoppers pay on a hosted BananaCrystal page and are returned to your store, and the order is marked paid automatically. Works on both the classic checkout and the WooCommerce Cart/Checkout blocks, with HPOS support. ## Legacy mode Keeps the original setup for the older app.bananacrystal.com. Enter your BananaCrystal Store Username and paste the Order Completion / Thank You, Order Pay, and Payment Notification (IPN) URLs into your BananaCrystal store settings. Choose your mode in the gateway settings — the legacy setup keeps working exactly as before. ## BENEFITS ### Benefits for your store or business: * Accept payments for your store or business almost free! * Payments settle instantly for your store or business with no risk of chargebacks saving you over 20% in fraud and chargeback fees…which you can then pass as savings on to your customers * Send payments to your local and international vendors for FREE. This will enable you access to new markets and industry segments at reduced costs and payment settlement times. * Accept subscription payments and manage subscription plans. ### Benefits for your customers: * BananaCrystal payment system works like PayPal, Stripe or CashApp but much better. This is because you are now able to accept and receive payments with NO FEES from over 150 countries. * Send and receive secure peer to peer payments to anyone instantly at no cost to you. * Fast secure, low-cost, borderless, local and international payments in USD powered by blockchain/crypto payment rails. * Customers send and receive secure payments (peer to peer) to your store instantly at no cost to you. * You and your customers get privacy on all your purchases. Your bank or credit card company does not need to know what you are purchasing…because your purchases are private. ## FEATURES * AI Agent mode for the new BananaCrystal platform, with the classic (legacy) setup still supported. * Works on both the classic checkout and the new WooCommerce blocks. * Quick installation and setup, see [guide](https://www.bananacrystal.com/docs/how-to-install-the-wordpress-woocommerce-plugin/). * Accept one-time payments or through subscriptions * Receive Instant Payment Notifications when a customer makes a payment or recurring payment for a subscription. * Quick configuration with your BananaCrystal store account and your Woocommerce store == Frequently Asked Questions == = What's the difference between AI Agent mode and Legacy mode? = AI Agent mode connects your store to the new BananaCrystal (agents.bananacrystal.com): shoppers pay on a hosted BananaCrystal page, return to your store, and the order is confirmed automatically. Legacy mode keeps the original setup for the older app.bananacrystal.com. Pick your mode in the gateway settings. = How do I set up AI Agent mode? = 1. In BananaCrystal, go to Stores > your store > Integrations and add a WooCommerce integration. 2. Paste the Order completion / thank-you, Order pay / return, and Payment notifications URLs shown in the gateway settings. 3. Copy your publishable key (starts with pk_live_) into the Publishable key field. 4. Save. = Where do I get my publishable key? = In BananaCrystal, open Stores > your store > Integrations > your WooCommerce integration. The publishable key starts with pk_live_. = Does AI Agent mode work with the WooCommerce block checkout? = Yes — the gateway shows on both the classic checkout and the WooCommerce Cart/Checkout blocks. = As a merchant, how do I start accepting payments using BananaCrystal? = First, setup your BananaCrystal merchant/business account for your Woocommerce store as follows: 1. [Sign up](https://app.bananacrystal.com/users/sign_up) for a BananaCrystal account (takes 2mins) 2. [Setup your merchant/business account](https://www.bananacrystal.com/business/signup) and start accepting and receiving payments (takes 5 mins). 3. Install and setup this plugin on your Woocommerce store and enable it for checkout and/or subscriptions. 5. When your customers send you payments, they settle instantly with NO RISK of CHARGEBACKS saving you over 20% in fraud and chargeback fees). = As a customer, how do I pay a Woocommerce store for products or services using BananaCrystal? = 1. Sign up for a BananaCrystal customer account (takes 2mins). 2. Fund your account (via a Bank Transfer ACH, SEPA, Credit/Debit Card, PayPal, CashApp, Crypto, etc) 3. Select BananaCrystal at checkout or through subscriptions and pay the merchant (for FREE). 4. Your payment settles instantly. = How do I install this plugin? = Follow the [Wordpress guidelines on how to install a plugin](https://wordpress.org/support/article/managing-plugins/#installing-plugins-1) Then navigate to the plugin's admin settings and enter your BananaCrystal store username, redirect url, order pay url, and payment notification webhook url. For a detailed guide, see [How to Install the BananaCrystal Payment Gateway Plugin](https://www.bananacrystal.com/docs/how-to-install-the-wordpress-woocommerce-plugin/) = Where do I get my store username? = Login to your BananaCrystal account and go to Store > Settings. = Where do I configure my redirect url or payment notification webhook or order pay url? Login to your BananaCrystal account and go to Store > Integrations. Then, add or update a Woocommerce Integration = Where do I get my subscription key or redirect url for thank you page? Login to your BananaCrystal account and go to Store > Integrations. Then, add or update an existing Woocommerce Integration enable subscriptions View the integration to find your subscription key. = Can I regenerate my subscription key or revoke previous key? = Yes you regenerate existing key and the previous key would be expired (in case the key is compromised or you need to rotate your keys). = Do you have an affiliate program? = We offer a [referral/partnership program](https://www.bananacrystal.com/partner-program/) = Where can I get support or talk to other users? = If you need help with this plugin, you can ask for help in the Plugin Forum. If you need help regarding a transaction, visit the [BananaCrystal Support Center](https://support.bananacrystal.com/) == Screenshots == 1. AI Agent mode — create a WooCommerce integration in BananaCrystal. 2. AI Agent mode — copy your publishable key. 3. AI Agent mode — shoppers pay on the hosted BananaCrystal checkout. 4. AI Agent mode — the order is confirmed automatically on return. 5. Legacy mode — BananaCrystal at customer checkout. 6. Legacy mode — the customer payment page. == Changelog == = 1.3.2 = * Security: Legacy mode payment notifications (IPN) are now confirmed with BananaCrystal before an order is marked paid. Notifications that BananaCrystal does not confirm are rejected. * Security: a confirmed payment must be in the order currency and cover the order total. A payment that does not match puts the order on hold for review. * Security: subscription plan lookups now use prepared queries, and creating, editing or deleting a subscription plan checks the user's permission. * All stores should update. = 1.3.1 = * AI Agent mode: the gateway settings now show the exact URLs to paste into your BananaCrystal WooCommerce integration (order completion / thank-you, order pay / return, payment notifications). * Clearer default payment title and description, with example placeholders in the settings. * Updated screenshots and FAQ for AI Agent mode. = 1.3.0 = * Added an AI Agent mode for stores on the new BananaCrystal (agents.bananacrystal.com), alongside the existing Legacy mode. Pick your mode in the gateway settings. * AI Agent mode: shoppers pay on a hosted BananaCrystal page and return to your store; the order is confirmed automatically. * Added Cart/Checkout Blocks support and declared High-Performance Order Storage (HPOS) compatibility. = 1.2.6 = * Bug fixes and checkout improvements. == Upgrade Notice == = 1.3.2 = Security fix: payment notifications are now verified with BananaCrystal before an order is marked paid. All stores should update.