Goal
Configure the app’s cart and checkout experience: what the screens say, which sections show (addresses, tips, coupons, terms, comments), how tips are offered, and — most importantly — how payment is taken: charged immediately, or held and settled after the order completes.
Every setting on this page is a plain WordPress option. Text, color, and yes/no settings are pushed into the app’s global phone data on the next app refresh; the payment-behavior settings are read server-side when an order is submitted.
Before you start
mam-woocommerce, WooCommerce, and Gravity Forms are active and you can see Mobile App Manager → WooCommerce in wp-admin.- You have the
manage_options capability to open the page (saving requires manage_woocommerce).
- A payment plugin (e.g. MAM Stripe Manager) is active — without one, paid orders cannot charge.
Steps
- Go to Mobile App Manager → WooCommerce.
- Work through the General, Cart, and Checkout tabs (tables below).
- Click Save Changes on each tab (each tab saves independently).
- Refresh the app (or wait for the next data refresh) and run a test order.
General tab
| Setting |
Choices |
What it controls |
| Order Type |
Pickup / Delivery |
The store’s default fulfillment type, sent to the app with the global app data (wc_order_order_type). |
| Show Tip and Review after order complete |
Yes / No |
When Yes, the customer’s most recent completed, un-reviewed order is pinned to the top of the home screen as a “Review your Order” card (with tip option). |
| Exclude Order ID from Review Prompt |
number |
One order id the review prompt always skips (e.g. a demo/sample order). Until this tab is first saved it defaults to 1542 (the legacy hard-coded value); save it empty or 0 to exclude no order. |
Cart tab
Text and color settings for the cart screen: cart title, empty-cart message, the Proceed to Checkout / Buy Now / Add to Cart / Update Cart / Change Dates / Remove Item button titles and colors. Empty text fields fall back to the app’s built-in labels.
Checkout tab — screen content
| Setting |
What it controls |
| Checkout Screen Title, section titles (Order Summary, Shipping Address, Login or Create Account, Payment Information, Shipment Details, Order pickup/delivery header) |
Headings on the checkout screen. |
| Show pickup/delivery option / Show Billing Address / Show shipping address / Show Coupons / Show Terms / Checkout has comments? |
Yes/No toggles for each checkout section. With coupons on, published, unexpired WooCommerce coupons are sent to the app and the customer can apply one at checkout. |
| Checkout message / comments field title / Terms of Service Message / Checkout Cart Empty Message |
The checkout texts. |
| Checkout Button Title / Color / Background Color |
The main checkout button. |
| Purchase Dialog Title / Message / Purchase Button / Cancel Button / Purchase Confirmation |
The confirm-purchase dialog. |
| Use Confirmation Screen? |
Whether a confirmation screen is shown after ordering. |
| Require address fields to place order |
Makes the address fields mandatory. |
| Go to home screen on back button |
Back from checkout goes home instead of to the cart. |
Checkout tab — tips
| Setting |
Choices |
What it controls |
| Tip Level One–Four |
Never / 1–20 |
The four tip choices offered at checkout. Choose Never to hide a slot. |
| Show Tip Option |
Yes / No |
Whether the tip section appears at all. |
| Driver Tip Level One–Four, Show Driver Tip Option for Deliveries |
Never / 1–20, Yes/No |
Same, for the separate driver tip on delivery orders. Pickup orders never carry a driver tip — the server enforces this even if the app sends one. |
Checkout tab — scheduling
| Setting |
Choices |
What it controls |
| Display as day time slots |
Yes / No |
Show pickup/delivery times as day + time-slot pickers. |
| Display as single location |
Yes / No |
Skip the location chooser when the store has one location. |
| Intra order buffer time |
1–60 |
Minutes between offered time slots. |
| Days allowed |
1–7 |
How many days ahead the customer can schedule. |
Checkout tab — payment: charge now, or hold and settle
| Setting |
Choices |
What it controls |
| Place Hold on Order |
Yes / No |
No (default): the card is charged for the order total when the order is placed. Yes: an authorization hold for 120% of the order total is placed instead — no money moves yet. The buffer covers post-order additions (e.g. a tip); only the final amount is ever captured. |
| # Days after Order Complete to Settle the Order |
1–7 |
How long after completion the held charge is captured (the “settle”). Settlement is executed by the MAM Product Vendors auto-settle cron through the mam_wc_settle_order hook — leave this setting unset to disable auto-settling entirely. |
With holds enabled, an order’s money is only captured at settle time, for the order total as it stands then. If you don’t run MAM WooCommerce Product Vendors (which provides the settle cron), use the mam_wc_settle_order hook to settle from your own code — see Hook: mam_wc_settle_order.
A Gravity Form can be embedded in checkout (for example to collect extra order information). It is wired through the checkout_custom_form option, which stores the Gravity Forms form id:
- The form is sent to the app pre-filled with the customer’s previous answers; submissions are saved to the customer’s profile and re-used on later orders.
- As of 26.19.3 this option has no field on the settings page — set it directly, e.g.
wp option update checkout_custom_form 42 (where 42 is the GF form id).
Notes
- All of these options are frozen
tsl-setting-* keys (e.g. tsl-setting-checkout_place_hold_on_order, tsl-setting-checkout_settle_order_days) read with plain get_option() — safe to set programmatically or via WP-CLI.
- Color values are stored as hex; legacy
r,g,b values are converted automatically when the page renders.
- The Refund tab is covered in Configure the cancel, feedback, and refund forms; the Color Settings tab styles the menu/checkout screens and seeds itself from the two theme colors the first time it runs.
Related articles
| Field |
Value |
| Article type |
Recipe (Admin) |
| Plugin slug |
mam-woocommerce |
| Applies to plugin version |
26.19.3+ |
| Category |
Building Your App |
| Audience |
WordPress admin |
| Estimated time |
15 minutes |
| Last verified |
2026-06-10 |
