Shop Settings: Configure Your Store

Shop Settings is where you configure the general preferences, payment setup, and all customizable text for your WhatsApp commerce experience. Settings are organized into 10 tabs covering everything from bank account details to WhatsApp Flow labels.

Accessing Shop Settings

  1. Open your Workspace
  2. Go to Shop in the sidebar
  3. Click Shop Settings

General Tab

The General tab contains the most critical settings:

Setting Description
Enable Order Processing Master toggle — must be ON for any commerce features to work
Assigned Agent The AI agent that handles commerce-related conversations
Currency Code ISO currency code (default: NGN)
Currency Symbol Display symbol (default: ₦)
Default Payment Method Cash on Delivery or Card Payment
Store Name Your store's display name
Settlement Bank Your bank (populated from Paystack's Nigerian bank list)
Account Number Your 10-digit NUBAN account number
Account Name Auto-filled when account number is validated

Bank Account & Paystack Subaccount

When you save bank account details, the system automatically creates or updates a Paystack Subaccount linked to your business. This enables payment splitting when customers pay by card — the order total goes to your bank account, and the Nviti platform fee is deducted automatically.

Customizable Text Tabs

These tabs control every piece of text your customers see on WhatsApp:

Main Menu

  • Menu header and body text
  • Button labels: Browse Products, My Cart, Checkout, Track Order

Catalogue

  • Category list header and body
  • Product list body text
  • Add to Cart CTA label
  • Search placeholder

Cart

  • Empty cart message
  • View Cart / Checkout / Clear button labels
  • Post-add-to-cart instructions
  • Cart Flow body text

Checkout

  • Start Checkout CTA
  • Flow body text
  • Confirm / Cancel button labels
  • Payment method selection header and body
  • Order confirmation prompt

Orders

  • Order confirmation title and message (supports {id} and {total} placeholders)
  • Order placed title
  • Track Order / My Orders CTA labels
  • Default status update note
  • Empty history message

Flow: Form Labels

Field labels for all WhatsApp Flows — Full Name, Phone, Address, City, State, Delivery Method, Variant, Quantity, Payment Method, etc.

Flow: Catalogue / Checkout / Cart / Order History

Screen titles and headings for each WhatsApp Flow type.

Technical Details

File: app/Filament/Workspace/Resources/ShopSettingsResource/Pages/EditShopSettings.php

  • Settings are stored in the company_settings table, falling back to defaults from commerce.php
  • Bank account fields are excluded from dynamic field generation — they use a custom buildBankAccountSection() method
  • Field keys use __dot__ separator (e.g., shop__dot__bank_code maps to config key shop.bank_code)
  • On save, syncPaystackSubaccount() is called to sync bank details to Paystack

Best Practices

  • Enable order processing first — No commerce features work without this toggle
  • Set your bank account early — Required for receiving card payments
  • Customize your menu text — Default text is generic; personalize it to match your brand voice
  • Test the checkout flow — Place a test order after configuring settings to verify everything works

Related

Keywords

shop settings, store configuration, currency settings, bank account, paystack subaccount, order processing, whatsapp commerce