====== Toweringmedia React Checkout Pro Express Extension for Magento 2 ======

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide in the Checkout & Payments category. Use this page for configuration, validation, and related module navigation.

===== Quick links =====

  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro|Magento 2 React Checkout Pro Extension]]

===== Overview =====

React Checkout Pro Express extends the base React Checkout Pro experience with faster express payment entry points designed to reduce checkout friction.

Key goals:
  * Reduce checkout steps for repeat and mobile-focused shoppers.
  * Keep wallet/express behavior consistent with your core payment gateway setup.
  * Preserve controlled fallback to standard checkout payment flow when express options are unavailable.

===== What this extension does =====

  * Adds express checkout components on top of React Checkout Pro.
  * Works with supported payment gateway integrations in the Toweringmedia checkout stack.
  * Supports staged rollout (disabled by default, then enabled after validation).

===== Visual examples =====

{{:magento2:extensions:screenshots:react-checkout-pro-express-storefront.png|React Checkout Pro Express storefront checkout (express buttons + standard payment area)}}
{{:magento2:extensions:screenshots:react-checkout-pro-express-before-email.png|React Checkout Pro before email entry (delivery/shipping/payment sections remain collapsed)}}
{{:magento2:extensions:screenshots:react-checkout-pro-express-fallback.png|React Checkout Pro after email entry and fallback standard checkout state}}
{{:magento2:extensions:screenshots:toweringmedia-module-react-checkout-pro-admin-top.png|React Checkout Pro storefront layout example}}
{{:magento2:extensions:screenshots:toweringmedia-module-react-checkout-pro-admin-fields.png|React Checkout Pro account-required/fallback behavior example}}

===== Installation =====

Install via Composer (example):

<code bash>
cd /path/to/magento
composer require toweringmedia/module-react-checkout-pro-express:<VERSION>
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
</code>

Confirm module status:

<code bash>
php bin/magento module:status Toweringmedia_ReactCheckoutProExpress
</code>

===== Configuration =====

Primary config area:
''Stores > Configuration > Sales > Checkout React Pro''

Suggested rollout sequence:
  - Ensure base React Checkout Pro is working first.
  - Enable Express section only after gateway prerequisites are configured.
  - Confirm checkout gating flow: before email is entered, downstream sections can remain collapsed by design.
  - Validate express behavior on both desktop and mobile.
  - Confirm fallback behavior to standard payment flow.

===== Prerequisites and compatibility =====

Use with:
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro|Magento 2 React Checkout Pro Extension]] (required base)
  * [[magento2:extensions:toweringmedia-module-authorizenet|Magento 2 Authorize.Net Payment Extension]] (common pairing)
  * [[magento2:extensions:toweringmedia-module-moneris|Magento 2 Moneris Payment Extension]] (if used in your payment stack)

Operational prerequisites:
  * HTTPS storefront enabled.
  * Valid payment credentials in the selected gateway.
  * Checkout JS/static assets deployed after module updates.
  * **Enable Express Checkout Section** turned on in Checkout React Pro config.

===== PayPal express behavior =====
On supported stores, PayPal express flow is routed through React Checkout Pro endpoints and Magento PayPal backend handling, so payer email/address return is handled in the standard express return pipeline.

===== Validation checklist =====

  * Express UI loads only when enabled.
  * Before email entry, delivery/shipping/payment sections can stay collapsed until required contact data is provided.
  * Express actions render correctly on desktop and mobile breakpoints.
  * Express transaction succeeds end-to-end in sandbox mode.
  * Fallback standard checkout remains available and functional.
  * Error handling and messaging are user-friendly when express path is unavailable.

===== Troubleshooting =====

  * **Express buttons not visible**: Verify module enablement, config switch, and gateway prerequisites.
  * **Express click has no action**: Check browser console errors, static content deployment, and cache state.
  * **Payment declined unexpectedly**: Confirm sandbox/live credentials and account/payment action compatibility.
  * **Only some browsers/devices fail**: Re-test with clean cache, verify wallet/browser support, and inspect CSP issues.

===== SEO and conversion links =====

  * [[https://toweringmedia.com/magento-2-react-checkout-pro-bundle|Magento 2 React Checkout Pro Bundle]]
  * [[https://toweringmedia.com/rcp-fulfillment-store-pickup-and-delivery-for-react-checkout-pro|RCP Fulfillment Add-on for React Checkout Pro]]
  * [[https://toweringmedia.com/magento-2-extensions|Magento 2 Extensions Catalog]]
  * [[https://toweringmedia.com/media/catalog/product/cache/f8158826193ba5faa8b862a9bd1eb9e9/m/a/magento_2_react_checkout_pro_1.png|React Checkout Pro product screenshot (live)]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:extensions:toweringmedia-module-react-checkout-pro|Magento 2 React Checkout Pro Extension]]
  * [[magento2:extensions:toweringmedia-module-authorizenet|Magento 2 Authorize.Net Payment Extension]]
  * [[magento2:extensions:toweringmedia-module-moneris|Magento 2 Moneris Payment Extension]]
  * [[magento2:start|Magento 2 docs home]]