wt_commerce
The WT Commerce Suite is an ultra-lean, decoupled e-commerce and booking ecosystem. It seamlessly unifies physical products, hotel rooms, and hourly appointments into a single, GDPR-compliant Viva Wallet smart cart.
The WT Commerce Suite is a lightweight, high-performance ecosystem built to solve a massive problem in the web development space: the database bloat and timezone bugs associated with traditional e-commerce and booking frameworks.
Built natively on Drupal's Entity and Field APIs, this module provides an enterprise-grade but incredibly simple solution for small and medium-sized businesses (SMBs). It decouples complex logic, separating the calendar from the checkout, and securely hands off the heavy lifting to the bank via a native Viva Wallet Smart Checkout integration. If you need a fast, profitable hybrid storefront where customers can buy a physical product, book a service, or request a free consultation with zero friction, this is your solution.
Core Features
- Universal Slide-Out Cart & Digital-Only Mode: Fast, accessible, session-based cart drawer that automatically detects digital goods (Dates/Appointments) and hides physical shipping requirements dynamically. Features a global "Digital-Only" toggle to completely bypass shipping and physical address collection for service-based businesses.
- Automated Receipts & Native Calendar Sync: Sends pristine, plain-text-optimized order confirmations that dynamically extract purchased item URLs and deduplicate cart data. Automatically generates and injects smart "Add to Google/Outlook Calendar" deep-links ([Item Title] | [Site Name]) for all bookings, completely bypassing Drupal Core's HTML-stripping quirks.
- Smart Zero-Cost Routing: Automatically detects €0.00 carts (e.g., Free Consultations or Quote Requests), cleanly hides payment UIs, and safely bypasses the bank API to generate the appointment without errors.
- Native Spam Protection: Built-in, cache-safe honeypot field that silently blocks bot submissions without requiring external modules or user-facing CAPTCHAs.
- GDPR & Frictionless Checkout: Built-in, translatable, and fully accessible GDPR/Privacy Policy consent enforcement. Natively captures the buyer's email and seamlessly passes it to the Viva Smart Checkout API for auto-pre-filling.
- Form Resubmission Protection: Implements the Post/Redirect/Get (PRG) pattern across all forms to prevent duplicate cart additions on accidental browser refreshes.
- Smart Product Variations: Built-in support for Sizes and Colors. Dynamically switches between select dropdowns and static text labels based on inventory, completely isolated from backend data ingestion via a secure $form_state vault.
- AJAX Delivery Options: Support for up to 3 distinct delivery methods with live AJAX updates and a global Free Shipping threshold (for physical products).
- Customizable Offline Payments: Rename the offline payment method to exactly fit your business model (e.g., "Cash on Delivery", "Pay at Clinic", or "Wire Transfer") with dynamic UI rendering.
- Viva Wallet Integration: Secure OAuth2 API connection and asynchronous Webhook verification using strict cryptographic tokens to instantly mark orders and bookings as 'Paid'.
- Native Multi-Currency & Dynamic Currency Conversion (DCC): Expand your business globally without adding technical complexity. Because WT Commerce integrates directly with Viva Wallet’s Smart Checkout API, the system automatically supports international payments. When an international customer enters their credit card, the system instantly reads the card's origin and offers them the ability to pay in their local home currency. You do not need to configure complex exchange rates in Drupal; the system handles the conversion on the fly and settles the funds into your merchant account in your native currency.
- Global Checkout with PayPal REST API (v2): Expand your storefront's global reach with our deeply integrated, enterprise-secure PayPal module. Built entirely on the modern PayPal REST API (v2), this feature seamlessly bridges the gap between your custom Drupal checkout flow and international buyers, allowing them to pay via their PayPal account or major credit cards.
- Direct Bank Transfer (IRIS / IBAN) & Smart Discount Engine: Take control of your revenue by bypassing high third-party gateway fees. The Direct Bank Transfer feature allows you to accept offline payments via standard IBAN e-Banking or modern instant-transfer networks like IRIS. It pairs a frictionless user experience with powerful financial incentives.
Use Cases:
- The Pure E-Shop (Physical & Digital Goods): Just need to sell products? Use the core module by itself. Sell physical items with intelligent variable shipping rates, custom delivery methods (like Courier or "Box Now"), and automated free-shipping thresholds. Selling e-books or services? Instantly toggle our 'Digital-Only Mode' to completely bypass shipping calculations and physical address collection for a frictionless, lightning-fast checkout.
- The Hotel System (Nightly Room Bookings): Running a boutique hotel or B&B? Enable the WT Simple Booking extension. Rent out rooms by the night with bulletproof availability checks. The cart automatically detects it is a digital booking and hides physical shipping requirements from the customer.
- The Appointment System (Hourly Slots): Running a clinic, salon, or consultancy? Enable the WT Slot Booking extension. Schedule professionals by the hour or minute using raw, timezone-safe server mathematics that prevent accidental double-bookings.
- The Ultimate Hybrid Store: Do it all at once. Allow a customer to buy a physical bottle of massage oil, book a 60-minute spa appointment, and reserve a weekend wellness suite. All three completely different entity types funnel into one unified shopping cart for a single, frictionless checkout.
Post-Installation
Because this is a multi-module suite, you must first enable the core WT Simple Pay module. You can then optionally enable the WT Simple Booking (Rooms) or WT Slot Booking (Appointments) extensions.
Once installed, the system automatically creates the necessary Content Types (wt_product, wt_room, wt_service) and native Views Dashboards.
Your next steps:
- Navigate to Configuration > Web services > WT Commerce: Payment & Cart Setup.
- Enter your Viva Wallet API credentials (Client ID, Secret, and Source Code), set your Webhook Security Token, and configure your GDPR consent texts.
- Go to Structure > Block layout and place the "WT Cart Toggle Button" in your site's Header, and the "WT Slide-Out Cart Drawer" in your Footer.
- Access your automatically generated operational dashboards at
/admin/wt-commerce/orders.
Additional Requirements
This project is engineered to be exceptionally lean and self-contained. It relies on Drupal Core's native HTTP client (Guzzle) and does not require any external Composer libraries.
- Drupal Core: 11.x
- PHP: 8.1 or higher
- External Account: A Viva Wallet Merchant Account (Sandbox or Production) is required to process online payments.
Recommended modules/libraries
Similar projects
- Drupal Commerce: The gold standard for massive retail. If you need multi-warehouse SKU decrementing, real-time FedEx weight calculations, and complex global taxation, you need Drupal Commerce. However, if you simply want a lean hybrid store for basic products and bookings, WT Commerce provides a frictionless alternative without the massive database overhead.
- BAT (Booking and Availability Management Tools): BAT is an incredibly powerful engine for state-driven availability. WT Commerce differs by offering a much simpler, decoupled approach specifically tied to a unified shopping cart, favoring mathematical slice-logic over heavy calendar entities.
Supporting this Module
This suite is built and maintained with ❤️ by Web-Thread.
To support this module, please consider starring the project repository, reporting issues in the queue, and using Viva Wallet to leverage their 0% acceptance fee corporate debit card program.
Community Documentation
- WT Commercial Suite promotional page
- Explore our Demo E-Shop
- Explore our Demo Hotel System
- Explore our Demo Appointment System
- WT Commerce Suite Official Documentation
- Project README
- Viva.com Developer Portal & Help Center
👋 Show Us What You've Built!
We would absolutely love to see how the WT Commerce Suite is helping your business or your clients. If you have launched a project using this module, please consider sending us a quick message at [email protected] with a link or a short case study of your storefront! Seeing real-world hybrid stores in action is the greatest reward for our open-source work, and it helps inspire future features for the whole community.