Wilby DocsGet Sandbox Keys

Settings

Read with GET /v1/settings, change with POST /v1/settings. Send only what you change; null clears a value back to the default.

SettingWhat it does
agent_accessWhich AI agents may order from you: mode all or only, allowed, blocked, verified_only.
agent_rulesYour own rules for AI agent orders, stricter than the customer's: max_order_cents, always_approval_required_above_cents, hours.
appsYour iOS and Android apps, so customers can approve inside your app.
brandingYour look on customer pages: display_name, accent_color, secondary_color, logo_data_uri, show_secured_by.
embed_originsYour websites that may show the Dashboard inside your own dashboard (up to 5 https origins).
first_setup_codeBefore a customer's first passkey, a one-time code proves it's them (default true).
google_ordersGoogle order updates: whether your key is saved.
listingWhat AI app directories ask for: one_liner, long_description, privacy_url, support, docs_url, example_prompts, reviewer_customer_ref, reviewer_steps.
passkey_websitesWhich of your websites can show the Face ID prompt themselves (in_page) and which use Wilby's window (wilby_window).
recommended_pctThe choice shown as recommended.
return_urlWhere Wilby's pages send the customer when they are done (https, or your app's own link).
rule_choices_pctThe percent choices offered to customers for extra charges (1 to 4).
screen_originsYour websites where Wilby's ready-made screens run (up to 10 https origins).
storefrontYour Agent Storefront: enabled, slug, name, description, login_url, api_url, answers, extras, times_path.
stripe_keyYour Stripe restricted key (saved, never shown again).
ucpGoogle's agent checkout (UCP): enabled, require_signatures, share_saved_addresses, prefer_mcp, public_base_url, version, terms_url, website_url, google_pay.
variable_amountWhether your final price can change after checkout (default false).
website_agentsAI agents on your own website: likely (record_only or ask_customer).
wordingYour own lines on customer pages (keys like extra_title; null goes back to Wilby's default).

Inside the Settings

FieldMeaning
accent_colorYour main brand color on customer pages, like #1E3059.
allowedWhether it is allowed (true or false), or the list of what is allowed.
always_approval_required_above_centsAbove this amount, the customer always approves the order themselves, whatever their limits.
androidYour Android apps: package_name and sha256_cert_fingerprints, so approving can happen inside the app.
answersWhat your Agent Storefront answers: locations, times, catalog, delivery, addresses.
api_urlYour Storefront API base address; Wilby calls it with signed requests.
blockedThe AI agents you refuse orders from.
client_keyYour Google Pay client key from your gateway, when it needs one.
daysA number of days, or the days of the week (0 = Sunday) for hours.
descriptionPlain text describing it. On an order: what was ordered.
display_nameYour business name as customers see it.
docs_urlYour help page for the connector.
enabledWhether it is turned on.
endEnd time (HH:MM, 24-hour).
example_promptsExample requests customers can try with your connector (up to 5).
extrasStorefront: the extras you accept (tip, promo_code, rewards). In a quote request: what the customer asked for.
gatewayYour Google Pay gateway (for example stripe).
gateway_merchant_idYour merchant id at the Google Pay gateway.
google_payGoogle Pay for agent checkout: gateway, gateway_merchant_id, merchant_id, merchant_name, stripe_version, client_key.
hoursWhen AI agents may order: tz (IANA time zone), days (0 = Sunday), start and end (HH:MM).
iosYour iOS app ids (Team ID + bundle id).
likelyAI agents on your website: record_only (record a likely agent visit) or ask_customer (the customer confirms above your amount).
login_urlYour sign-in page for customers connecting an AI agent.
logo_data_uriYour logo as a PNG or JPEG data URI (under 150 KB).
long_descriptionThe long description for AI app directories (up to 2,000 characters).
max_order_centsThe most an AI agent may order at once from you.
merchant_idWilby's id for the store (mer_…).
merchant_nameThe store name shown in Google Pay.
modesandbox (test) or live. In agent access: all or only.
nameA name.
one_linerOne sentence for AI app directories (up to 200 characters).
package_nameYour Android package name.
prefer_mcpGoogle agent checkout: prefer the MCP connection.
privacy_urlYour privacy policy address.
public_base_urlGoogle agent checkout: your public address.
require_signaturesGoogle agent checkout: require signed requests.
reviewer_customer_refThe customer account AI app directory reviewers sign in with.
reviewer_stepsSteps for directory reviewers.
secondary_colorYour second brand color.
sha256_cert_fingerprintsYour Android app's signing certificate fingerprints.
share_saved_addressesGoogle agent checkout: share the customer's saved addresses.
show_secured_byWhether "Protected by Wilby" shows on customer pages.
slugYour storefront's short name in its address (3–40 lowercase letters, digits and dashes).
startStart time (HH:MM, 24-hour).
stripe_versionThe Stripe API version for Google Pay.
supportYour support contact for AI app directories.
terms_urlYour terms address.
times_pathYour open-times endpoint: /pickup-times (default) or /open-times.
tzAn IANA time zone, like America/New_York.
verified_onlyAgent access: only take orders from agents that signed their requests.
versionThe version.
website_urlYour website address.