The Publica.la shopping cart system enables users to purchase various product types through flexible purchase flows and payment methods.

Supported Products

• Products with prices (including promotional prices)
• Recurring subscriptions (with/without private prices)
• One-time subscriptions (with/without private prices)
• Subscriptions with both private and public prices

Note: Users can add only one subscription per cart.

Purchase Entry Points

• From product pages → Cart
• From subscription pages or direct links → Cart
• From gift pages → CheckoutPaymentLinks (not yet supported in cart)
• From the reader → CheckoutPaymentLinks (pending cart integration)

Purchase Flows

Add to Cart

Allows adding items while continuing to browse, suitable for multiple-item purchases.

Buy Now

Adds the item and immediately redirects to checkout for quick single-item purchase.

Cart-Based Purchase Scenarios

1. Standard purchase: Product → Cart → Checkout → Payment → Thank you
2. 100% discount coupon: Product → Cart → Coupon → Checkout → Thank you
3. Partial discount coupon: Product → Cart → Coupon → Checkout → Payment → Thank you
4. Subscription purchase: Subscription → Cart → Checkout → Payment → Thank you
5. Subscription with full discount: Subscription → Cart → Coupon → Checkout → Thank you
6. Subscription with partial discount: Subscription → Cart → Coupon → Checkout → Payment → Thank you
7. Free subscription: Subscription without price → Cart → 100% Coupon → Checkout → Thank you

Direct Gift Purchases

Gift page → CheckoutPaymentLinks → Payment → Thank you

Payment Processing

• Automatic gateway selection based on currency, location, and available methods
• Supports credit/debit cards (Stripe/MercadoPago), local payment methods, and alternatives
• Multi-currency support with automatic conversion when applicable

Cart Restrictions and Rules

• Only one product per cart when using 100% discount coupons
• Only one subscription per cart
• Coupons must be applied before payment and cannot be combined
• Shipping costs and address required only for physical products

Currency Handling

• Users can select preferred currency during checkout
• System validates currency availability and selects tenant's primary currency if unavailable

Automatic Checkout (Direct Purchase Links)

Supports URLs with parameters to clear cart, add product, and open checkout automatically, enhancing marketing and affiliate use cases.

For detailed information, see the Shopping Cart Overview and Automatic Checkout documents.