FluentCart Checkout Integration
FluentCart is a WordPress ecommerce plugin built by the Fluent team. WP Smart Consent integrates with the FluentCart checkout, adding the opt-in checkbox between the billing fields and the payment methods section.
Enabling the Integration#
In the WP Smart Consent dashboard, go to Checkout Sources and toggle FluentCart on. No additional configuration is needed on the FluentCart side. The checkbox appears on all FluentCart checkout pages immediately after saving.
Custom Fields#
FluentCart does not have a per-form field selector like form plugins do. To forward additional data beyond the standard fields, use the Global data fields tab in the WP Smart Consent dashboard. Set the source to Order meta and enter the FluentCart order meta key as the source key. The CRM key is what your destination platform uses to identify that field — for example city in FluentCRM or CITY in Mailchimp.
How It Works#
WP Smart Consent renders the checkbox via the fluent_cart/before_payment_methods hook, placing it directly above the payment method selector. The visitor’s consent value is captured at order creation time via fluent_cart/checkout/prepare_other_data while the POST data is still available, and stored on the order object.
Forwarding fires on fluent_cart/payment_status_changed_to_paid, which only triggers after the order is confirmed as paid. This covers all gateway types — immediate gateways like Stripe, async gateways like PayPal, and offline methods like cash on delivery all trigger correctly once payment is confirmed.
What Gets Forwarded#
Email, first name, last name, company, billing address, city, state, postcode, country, phone, order total, and source URL. Order total is converted automatically from FluentCart’s cent-based storage to a decimal string. Source URL is the page the customer arrived from, captured from the HTTP referer at checkout time.
Send on Unchecked#
When enabled on a specific CRM destination in its Options tab, that destination receives contact data from every paid FluentCart order regardless of whether the checkbox was ticked. The contact is forwarded with the unchecked state so your CRM knows explicit consent was not given. Each CRM destination evaluates this independently.
Troubleshooting#
Checkbox not appearing — confirm the integration is enabled and that fluent_cart/before_payment_methods fires on your checkout page. Some FluentCart themes or checkout customisations may skip this hook.
Contact not forwarded after purchase — forwarding fires on fluent_cart/payment_status_changed_to_paid. Orders that remain pending or fail payment never trigger this and are not forwarded. Check the order status in FluentCart to confirm it reached paid status.
Order total showing incorrectly — FluentCart stores totals in cents. WP Smart Consent divides by 100 automatically. If the value is consistently wrong, confirm your FluentCart version stores amounts in the same format.