--- type: use-case title: Shop Experience url: "https://hub.jelou.ai/use-cases/shop-experience" markdown: "https://hub.jelou.ai/use-cases/shop-experience.md" jobs: - charge inside WhatsApp - "keep my store's checkout when selling through chat" products: - payments - shop access: public --- # Shop Experience The customer buys without leaving WhatsApp; you decide whether payment closes inside the chat with Jelou Payments or in the checkout your store already has in Shopify or WooCommerce. Shop manages the commerce, checkout is the closing flow, and payment is only the final step. Jelou Payments and your store's native checkout solve that step in two different ways. ## Route A · Jelou Payments Jelou Payments is purely the payment platform: it opens the provider's official checkout inside WhatsApp (WebView) and confirms the purchase once that provider returns the real payment status. It resolves the payment step — it does not manage catalog, inventory, or shipping rules. ### What you need - A payment provider connected via BYOK — Mercado Pago, Stripe, PayPal, PayPhone, Wompi, Conekta, Kushki, Placetopay, or Niubiz — installed from the Marketplace with its own credentials. - A verified WhatsApp Business account. Without verification, checkout falls back to the device's external browser. - The Payment node in your flow, pointing to the connected integration. - Status rules: what the flow answers if payment comes back approved, declined, or pending. Check the [provider catalog](https://docs.jelou.ai/guides/integraciones/pagos/proveedores.md) before installing, to confirm it supports WebView in your country. ### How it's built 1. **Install the provider from the Marketplace** — Pick the gateway the business already uses — or wants to use — and confirm it supports embedded WebView in its country. 2. **Test it, then connect your real account** — "Try with Jelou" validates the whole flow without your own credentials, up to 10 tests per setup. Once it's validated, connect your production credentials on the same installation — the workflow doesn't need to be rebuilt. [Docs](https://docs.jelou.ai/guides/integraciones/pagos/modo-prueba.md) 3. **Add the Payment node to your flow** — In Canvas, point the Payment node to the connected integration. WebView opens automatically if the provider supports it and the account is verified. 4. **Test it on your real WhatsApp, not the tester** — The tester doesn't open the checkout's WebView. Send yourself a test order on WhatsApp, in test mode with no real funds, before publishing. ![Modal to choose between Try with Jelou or Connect my account](https://cdn.sanity.io/images/sz9welmm/production/3417f02420ab1b13f99af3ff6871008438ade5ec-1024x694.jpg) *Test mode: validate the whole flow before connecting the provider's real account.* > Shipping isn't included: Jelou Payments only resolves the payment step — delivery logistics depend on the journey and your implementation. ## Route B · Jelou Shop / your store's native checkout Instead of charging inside the chat, the order closes in the checkout your Shopify or WooCommerce store already has — keeping your own payment methods and your shipping and logistics rules exactly as they are in the store. It doesn't go through Jelou's Payment node or any BYOK gateway. ### What you need - A store connected via OAuth — Shopify or WooCommerce — from the Marketplace or the Jelou Agent. The Jelou Shop MCP is included automatically. - Turn on use_external_checkout: true when running get_and_clear_cart, so Jelou hands back the link to your real checkout instead of opening its own payment flow. - Your store already ready to sell: payment methods, taxes, and shipping rules set up in Shopify or WooCommerce. ### How it's built 1. **Connect your store from the Marketplace** — Shopify: sign in, pick the store, and authorize the Jelou Commerce app. WooCommerce: enter your store's domain, sign in to WordPress, and approve the permissions. [Docs](https://docs.jelou.ai/guides/integraciones/e-commerce/woocommerce.md) 2. **Confirm the authorization** — You'll see the successful-connection message, and the integration card will show the connected account. You can now sync products and orders. 3. **The agent builds the cart and closes into your checkout** — With Jelou Shop connected, the agent searches products and adds items to the cart via WebView or conversationally. When the order closes with use_external_checkout: true, Jelou hands back the real link to your checkout instead of opening its own payment flow. 4. **The customer pays outside the chat, in your store** — They complete the purchase in the official Shopify or WooCommerce checkout, with the payment methods, taxes, and shipping already configured there. ![Catalog journey in WebView: search in chat, product page with variants, and add to cart](https://cdn.sanity.io/images/sz9welmm/production/15d590877f6df5dcddf84a3c28c79d2c1c2b65bc-1536x1024.jpg) *The agent builds the cart in chat before you decide which route closes the payment.* > This is the key difference from Jelou Payments: here your shipping and logistics rules are kept exactly as configured in the store. ## What to watch for - The flow shouldn't move forward as if payment were approved while the status is pending; that's common with transfers and wallets. - Test mode doesn't process real payments and caps out at 10 tests per setup — don't confuse it with production. - use_external_checkout is only available if you connected the store via Shopify or WooCommerce. - Don't mix up the routes: Jelou Payments charges through BYOK gateways; the native checkout charges entirely on your e-commerce platform. ## Tips - Start with the gateway or the store the business already uses, if it's supported. - Return the order number and payment status in the same message. - Validate the whole flow in test mode before connecting the real account. [See the full detail in Docs](https://docs.jelou.ai/guides/integraciones/pagos/experiencias/tipos-de-experiencia.md)