OMS Settings
OMS Settings control how each WhatsApp account handles catalogs, shopping carts, shipping address collection, order confirmation, and payment requests. Settings are per WhatsApp account.
Where to Find This
- Go to Settings → OMS Settings.
- Select the WhatsApp Account you want to configure.
WhatsApp Account & Commerce
- Show catalog storefront icon: displays the storefront icon and catalog browse button inside WhatsApp chat.
- Enable shopping cart: lets customers add products to a cart and send it as an order message.
- Catalog feature not available: means WhatsApp Commerce is not active for the selected account. Ensure a commerce catalog is linked to this WABA.
Order Flow
- Manual: staff reviews the order, confirms it, and requests payment manually. Use this for high-value or custom orders that need review.
- Confirm → Pay: valid orders are auto-confirmed on creation, then a payment request is sent automatically. Reduces staff effort for standard orders.
- Pay → Confirm: a payment request is sent first. The order auto-confirms only after WhatsApp Pay captures the payment. Use this when prepayment is required.
- Auto-collect shipping address: automatically asks for a shipping address in WhatsApp for physical product orders after cart checkout.
- Collect order instructions: after address confirmation, Socialone opens a WhatsApp Flow to collect per-order instructions and optional attachments from the customer (e.g. delivery notes, special requests). Enabling this auto-provisions a WhatsApp Flow the first time.
WhatsApp Pay (UPI)
WhatsApp Pay uses UPI for in-chat payments (currently available for India). Configure these fields before registering with Meta:
- UPI VPA (Merchant Handle): your registered UPI virtual payment address (e.g.,
merchant@bankname). Shown to customers as the payee. - Merchant Category Code (MCC): 4-digit RBI business category code. Common examples include Grocery Stores (5411), Restaurants (5812), Clothing (5621), Electronics (5734), Pharmacies (5912), Services (7389), and Education (8299). Use the code that best matches your primary business.
- UPI Purpose Code: payment purpose shown during UPI transaction. Options include general payment, goods purchase, bill payment, and merchant payment.
- Payment Note: short customer-facing message displayed on the UPI payment screen. Maximum 60 characters.
- Register with Meta: creates the payment configuration on the selected WhatsApp account using the fields above. Must be done before payment requests can be sent.
- Remove Payment: deregisters the payment configuration from Meta and disables payment requests for this account.
Importer / Compliance Details
Required by Meta when no commerce catalog is linked to the WABA and goods are being sold:
- Country of origin: country where goods are manufactured or sourced.
- Importer name: legal name of the importing business entity.
- Importer address: address line 1, address line 2, city, zone/state code, and postal code.
Delivery & Shipping
These settings apply across all order channels — WhatsApp commerce and the web store. Find them under Settings → OMS Settings → Delivery.
- Delivery charge mode: how shipping costs are applied.
- Merchant Absorbs — you cover delivery; customers see no shipping charge.
- Free Delivery — delivery is free for all orders.
- Flat Rate — a fixed charge added to every order. Set the amount in Flat Delivery Fee.
- Live Courier Cost — delivery is calculated in real time from your courier integration based on the customer's pincode and cart weight.
- Flat Delivery Fee: the fixed delivery amount applied when Delivery Charge Mode is set to Flat Rate.
- Quote Confirm TTL (minutes): for Live Courier Cost — how many minutes the customer has to accept the delivery quote before it expires. Default is 15 minutes.
- Quote Buffer %: a markup percentage added to live courier quotes before showing them to the customer (e.g. 10% adds a 10% buffer above the courier's raw cost). Set to 0 to pass through the exact cost.
- Live Cost Fallback: what happens if Socialone cannot fetch a courier quote for a Live Courier Cost order.
- Hold — sets order sub-status to
shipping_quote_failedand alerts staff. - Flat Fee — falls back to the Flat Delivery Fee if set.
- Merchant Paid — absorbs the cost silently and continues the order.
- Hold — sets order sub-status to
- Courier Selection: for Live Courier Cost — which quote to use when multiple couriers are available.
- Cheapest (default) — select the lowest-cost courier.
- Fastest — select the fastest estimated delivery.
- Priority — use a fixed priority list configured per courier.
- Minimum Order Value: customers must reach this cart subtotal before checkout is allowed. Leave blank for no minimum.
- Cash on Delivery (COD): enable to offer COD as a payment option. Set a COD Maximum Order Value to restrict COD to orders below that amount.
- Excluded Pincodes: list of pincodes where delivery is unavailable. Customers entering these pincodes at checkout see a "delivery not available" message.
- Excluded States: block entire states from delivery. All pincodes in an excluded state are blocked.
- Included Countries: restrict delivery to specific countries. Leave blank to allow all countries (default). Set to restrict to India-only or specific international markets.
Tax
- Prices include tax: when enabled, the product price already includes GST. Tax is extracted from the total at invoice time rather than added on top. Use this when your listed prices are MRP.
- When disabled, tax is calculated from each product's individual tax rate and added on top of the price at checkout.
Invoice Settings
- Invoice series mode: Single series for whole org numbers invoices sequentially across all locations (INV-0001, INV-0002, …). Separate series per location numbers invoices independently per location, useful for multi-GSTIN chains where each branch invoices separately.
- Invoice prefix: custom prefix prepended to invoice numbers (e.g.
MUMproduces MUM-0001). Leave blank to use the defaultINVprefix.
Order Routing Settings
These settings control how Socialone routes orders to fulfillment locations and handles order timing. See Order Routing for a full explanation.
- Routing policy: Nearest (default), Warehouse First, or Store First — determines which location wins when multiple are eligible.
- Auto-routing: enabled by default. Disable to assign fulfillment locations manually on every order.
- Pay-first TTL (minutes): how long (default 45 min) a stock reservation is held for a pay-first order waiting for payment. After expiry, the reservation releases.
- Stall alert (hours): hours before Socialone sends a staff alert for a confirmed or COD order that has not moved. Default is 24 hours.
- Auto-cancel on expiry: when enabled, pay-first orders that reach their TTL are cancelled automatically. When disabled, expired orders remain as leads.
- Default package dimensions: length × breadth × height (cm) used for courier quotes when no product shipping weight is set.
Service Staff Assignment
- Staff assignment strategy: how Socialone auto-assigns staff to service bookings when no specific staff member is selected at booking time.
- Least busy — assigns the staff member with the fewest bookings that day.
- Round robin — rotates through staff based on the last assignment.
- Manual — leaves bookings unassigned for staff to claim.
Custom Sub-Statuses
Your organization can define custom sub-statuses that map to canonical order states. Custom sub-statuses appear alongside the standard status labels in order lists and history, letting you use business-specific terminology without changing the underlying lifecycle.
- Code: short internal identifier (e.g.
awaiting_lab). - Label: customer-facing or staff-facing display name (e.g. "Awaiting Lab Results").
- Canonical state: the standard status this sub-status maps to (e.g.
processing). Routing and notification logic uses the canonical state. - Order type: optionally restrict the sub-status to Product Orders or Service Bookings.
Custom sub-statuses are configured in Settings → OMS Settings → Custom Statuses.
Common Blockers
- No WhatsApp account: connect an active WhatsApp account before configuring OMS settings.
- Payment registration fails: confirm the UPI VPA is valid and the MCC matches your business type as registered with your bank.
- Catalog controls not appearing: WhatsApp Commerce must be active for the account. Check that a linked commerce catalog exists.
- Auto-collect address not triggering: only activates for physical product orders. Digital and service products skip address collection.
- Delivery unavailable for a valid pincode: check Excluded Pincodes and Excluded States. If using a live courier, verify the courier covers that area.
- COD not appearing: enable COD in settings and confirm the order total does not exceed your COD maximum.
Related Docs
Related product
Commerce & Orders for WhatsApp selling
Manage WhatsApp catalogs, products, variants, bulk imports, product messages, carts, payments, and order follow-up from one Socialone workspace.
View product →