| Setting | What it does |
|---|
agent_access | Which AI agents may order from you: mode all or only, allowed, blocked, verified_only. |
agent_rules | Your own rules for AI agent orders, stricter than the customer's: max_order_cents, always_approval_required_above_cents, hours. |
apps | Your iOS and Android apps, so customers can approve inside your app. |
branding | Your look on customer pages: display_name, accent_color, secondary_color, logo_data_uri, show_secured_by. |
embed_origins | Your websites that may show the Dashboard inside your own dashboard (up to 5 https origins). |
first_setup_code | Before a customer's first passkey, a one-time code proves it's them (default true). |
google_orders | Google order updates: whether your key is saved. |
listing | What AI app directories ask for: one_liner, long_description, privacy_url, support, docs_url, example_prompts, reviewer_customer_ref, reviewer_steps. |
passkey_websites | Which of your websites can show the Face ID prompt themselves (in_page) and which use Wilby's window (wilby_window). |
recommended_pct | The choice shown as recommended. |
return_url | Where Wilby's pages send the customer when they are done (https, or your app's own link). |
rule_choices_pct | The percent choices offered to customers for extra charges (1 to 4). |
screen_origins | Your websites where Wilby's ready-made screens run (up to 10 https origins). |
storefront | Your Agent Storefront: enabled, slug, name, description, login_url, api_url, answers, extras, times_path. |
stripe_key | Your Stripe restricted key (saved, never shown again). |
ucp | Google's agent checkout (UCP): enabled, require_signatures, share_saved_addresses, prefer_mcp, public_base_url, version, terms_url, website_url, google_pay. |
variable_amount | Whether your final price can change after checkout (default false). |
website_agents | AI agents on your own website: likely (record_only or ask_customer). |
wording | Your own lines on customer pages (keys like extra_title; null goes back to Wilby's default). |
| Field | Meaning |
|---|
accent_color | Your main brand color on customer pages, like #1E3059. |
allowed | Whether it is allowed (true or false), or the list of what is allowed. |
always_approval_required_above_cents | Above this amount, the customer always approves the order themselves, whatever their limits. |
android | Your Android apps: package_name and sha256_cert_fingerprints, so approving can happen inside the app. |
answers | What your Agent Storefront answers: locations, times, catalog, delivery, addresses. |
api_url | Your Storefront API base address; Wilby calls it with signed requests. |
blocked | The AI agents you refuse orders from. |
client_key | Your Google Pay client key from your gateway, when it needs one. |
days | A number of days, or the days of the week (0 = Sunday) for hours. |
description | Plain text describing it. On an order: what was ordered. |
display_name | Your business name as customers see it. |
docs_url | Your help page for the connector. |
enabled | Whether it is turned on. |
end | End time (HH:MM, 24-hour). |
example_prompts | Example requests customers can try with your connector (up to 5). |
extras | Storefront: the extras you accept (tip, promo_code, rewards). In a quote request: what the customer asked for. |
gateway | Your Google Pay gateway (for example stripe). |
gateway_merchant_id | Your merchant id at the Google Pay gateway. |
google_pay | Google Pay for agent checkout: gateway, gateway_merchant_id, merchant_id, merchant_name, stripe_version, client_key. |
hours | When AI agents may order: tz (IANA time zone), days (0 = Sunday), start and end (HH:MM). |
ios | Your iOS app ids (Team ID + bundle id). |
likely | AI agents on your website: record_only (record a likely agent visit) or ask_customer (the customer confirms above your amount). |
login_url | Your sign-in page for customers connecting an AI agent. |
logo_data_uri | Your logo as a PNG or JPEG data URI (under 150 KB). |
long_description | The long description for AI app directories (up to 2,000 characters). |
max_order_cents | The most an AI agent may order at once from you. |
merchant_id | Wilby's id for the store (mer_…). |
merchant_name | The store name shown in Google Pay. |
mode | sandbox (test) or live. In agent access: all or only. |
name | A name. |
one_liner | One sentence for AI app directories (up to 200 characters). |
package_name | Your Android package name. |
prefer_mcp | Google agent checkout: prefer the MCP connection. |
privacy_url | Your privacy policy address. |
public_base_url | Google agent checkout: your public address. |
require_signatures | Google agent checkout: require signed requests. |
reviewer_customer_ref | The customer account AI app directory reviewers sign in with. |
reviewer_steps | Steps for directory reviewers. |
secondary_color | Your second brand color. |
sha256_cert_fingerprints | Your Android app's signing certificate fingerprints. |
share_saved_addresses | Google agent checkout: share the customer's saved addresses. |
show_secured_by | Whether "Protected by Wilby" shows on customer pages. |
slug | Your storefront's short name in its address (3–40 lowercase letters, digits and dashes). |
start | Start time (HH:MM, 24-hour). |
stripe_version | The Stripe API version for Google Pay. |
support | Your support contact for AI app directories. |
terms_url | Your terms address. |
times_path | Your open-times endpoint: /pickup-times (default) or /open-times. |
tz | An IANA time zone, like America/New_York. |
verified_only | Agent access: only take orders from agents that signed their requests. |
version | The version. |
website_url | Your website address. |