Quick Start Guides

Get up and running quickly with these step-by-step guides for building with Finqu.

Build a shopping agent

Enable UCP on a store channel.
Read the store’s /.well-known/ucp profile to discover its capabilities and REST or MCP transports.
Set up agent authentication and capability negotiation.
Search products, build a cart, and follow the supported fulfillment and checkout flow, including Finqu’s hosted payment handoff.
Use the Integration Guide for the full journey and the UCP Reference for capability details.

Choose a Worker and give it custom instructions, or define a Playbook for a multi-step workflow.
Configure the MCP Tools and Guidelines it needs.
In Work Hub, configure an Event for the store activity or cron schedule that should start the work.
Connect the trigger to the Worker or Playbook and check the behavior with a representative scenario.

For conversational work in the admin, start with Success Agent.

Start with the storefront getting-started guide. It covers the headless development setup; the Storefront GraphQL API supplies commerce data and operations.

Follow Apps & integrations, configure OAuth authentication, and use the Admin REST API. Register webhooks when your service needs notifications about store changes.

Clone or download your store’s theme from the Finqu admin or Git repository (or use finqu theme configure and finqu theme download).
Open the theme folder in your code editor.
Explore the structure: templates, layouts, sections, assets, and settings (see Theme directory structure and Theme structure).
Edit templates (e.g., product.liquid, collection.liquid) to change storefront appearance.
Add or update assets (CSS, JS, images) in the assets/ folder.
Preview locally (recommended): Use the Theme Development Kit for a local server with real store data and hot reload. See Installation and Getting started, or run finqu theme dev from the CLI. You can also preview changes in the admin.
Test your theme on different devices and browsers.
When ready, deploy with finqu theme deploy or upload/push your theme via the Finqu admin and publish it.

For template structure, Liquid variables, and unsubscribe handling, see Marketing Messages.

In the Finqu admin, go to Marketing > Messages.
Click “Create new message” and select “Write HTML” as the message type.
Use MJML or HTML and Finqu variables (e.g., {{ customer.first_name }}) for personalization.
Add images, buttons, and dynamic content as needed.
Preview your email in the admin.
Send a test email to yourself to check rendering.
Schedule or send the campaign to your audience.

For directory layout, MJML, and template fundamentals, see Email Themes.

In the Finqu admin, go to Online Store > Settings > Purchasing.
Under the “Emails” section, select the transactional email you want to edit (e.g., order confirmation).
Update the content, branding, and layout as needed using MJML or HTML.
Use Finqu variables to include order, customer, or store data.
Preview and send a test email to verify changes.
Save and activate the updated template.

For print theme structure and available templates, see Print Themes.

In the Finqu admin, go to Online Store > Settings > Purchasing.
Under the “Prints” section, select the print template you want to edit (e.g., invoice, packing slip).
Edit the layout, branding, and add or remove fields as needed using HTML and Liquid.
Use Finqu variables for order and customer information.
Preview the printout with sample data.
Save and use the updated template for your store’s documents.

For feed views, $FEED_ITERATOR, and Liquid usage, see Feed Templates.

In the Finqu admin, go to Products > Feeds or open the feed configuration/template.
Choose the feed type (e.g., Google Shopping, Facebook, custom XML/CSV).
Adjust which products and fields are included using filters and mapping.
Add custom fields or logic if needed.
Preview or download the feed to verify output.
Connect the feed to your marketing channel or partner platform.