Connecting other software

Open Connections from your user menu to manage integrations. Each card explains what the integration does and how to connect it.

Getting paid: Stripe

Take card payments through payment links and driver QR codes. Payments go to your Stripe account, with payouts to your bank. Bottle does not hold the money.

See Getting paid for setup, invoices and payment methods.

Accounting: Xero

Sync customer records in both directions. Send Bottle invoices and payments to Xero, and bring the fully paid status of those linked invoices back into Bottle. Sync runs automatically or when you select Sync now.

Bottle does not import Xero invoices, maintain your accounts ledger or file VAT returns. See Accounting for details and limitations.

Shops: Shopify and WooCommerce

Import your shop’s product catalogue and set up automatic imports of supported paid orders for delivery. Your shop remains responsible for invoices, payments and refunds. Bottle does not push prices or stock changes back to the shop.

New connections start with Import new orders automatically switched on. For WooCommerce, approving this in WordPress grants Read/Write access and starts notification setup. Existing catalogue-only connections can choose Approve in WordPress without disconnecting. Bottle only uses remote writes to manage its own order notifications. A read-only connection can still pull the catalogue. Shopify needs a suitable Admin API token, order permissions and the matching app client secret, followed by Set up automatic orders. It is a manual credential connection, not a Shopify app installation flow. Check for Receiving orders before relying on either feed.

You can connect more than one shop, two on the same platform included, each with its own name and settings. See Connecting your shop for setup, supported imports and more than one shop.

Assistants: Claude and ChatGPT

Connect an assistant to ask questions and use supported Bottle tools. You control its permissions, and it cannot access more than your own role allows.

See Connecting an assistant.

Messaging: WhatsApp

WhatsApp ordering is planned and is not available to configure yet.

Keys for anything else

Use an API key for your own integrations, scripts or reporting tools. Grant only the permissions the integration needs.

Create and manage keys under Connections. See For developers for authentication and API details.

Owners, admins and technical users can manage keys. Technical users can grant operational data access to an integration even though they cannot open those records in the app. Check permissions before sharing a key.

Select View activity to see requests made with valid API keys during the last 30 days. Each entry shows the key name, request type and route, required permission, response status, time taken and available IP address. You can view a single key, show unsuccessful requests or move through older entries. Revoking a key does not remove its recent activity.

Bottle records request metadata, not passwords, full keys, search values, request bodies or returned customer details. Traffic sizes are shown only when the request or response reports its size; a dash means it was not reported. Activity is hidden after 30 days and older entries are deleted by the daily retention job.

What every connection has in common

• Access is limited to the permissions granted.
• Saved credentials are encrypted and are not displayed again.
• Disconnecting stops access without deleting your Bottle records.
• Changes made through a connection are attributed to it.