Support

Store Kiosk is an iPad self-order app for farm stands and small merchants who use Square. Customers browse your Square catalog, build a cart, and pay on a Square Stand or paired reader without staff at the device.

This page covers setup help, common questions, and how to reach Ryan’s Goslings about the app.

App: Store Kiosk
Bundle ID: com.ryansgoslings.kiosk
Platform: iPad (iOS 17+)

Contact us

For questions about Store Kiosk (setup, configuration, or the app itself):

We typically respond within a few business days. Include your iPad model, iOS version, and whether you are using Square Sandbox or Production if you are reporting a problem.

Privacy: See our Privacy Policy.

Square payments, readers, or account issues: Contact Square Support or your Square account team. Store Kiosk connects to your Square account; Ryan’s Goslings does not process payments or access your Square dashboard on your behalf.

Before customers can order

The kiosk stays on a setup screen until staff complete all of the following in Staff settings:

  1. Accept the self-service deployment terms — confirms the kiosk runs during business hours while someone from your business is on the property and available to assist.
  2. Add at least one Help contact — name and phone number shown when customers tap Help. The iPad does not place calls; customers call on their own phone.
  3. Enter Square credentials — Application ID, Location ID, and access token for Sandbox (testing) or Production (live sales).
  4. Save and refresh the catalog.

Default staff PIN on first launch is 1234. Change it in settings after setup.

Getting started

  1. Create a Square application in the Square Developer Dashboard.
  2. Enable Mobile Payments SDK and create an access token with these scopes: ITEMS_READ, ORDERS_WRITE, PAYMENTS_WRITE, MERCHANT_PROFILE_READ.
  3. Install Store Kiosk on your iPad from the App Store (or TestFlight during beta).
  4. Open Staff settings from the idle screen, complete the steps above, and run a test order.

Test in Sandbox first. Use the mock reader in staff settings if you do not have a physical Square reader connected.

Staff settings

Staff can configure the kiosk in two ways:

  • On the iPad — tap Staff settings on the idle screen and enter the PIN.
  • From another device on the same Wi‑Fi — open the local settings URL or scan the QR code shown in staff settings. The page is served only from the iPad; nothing is uploaded to ryansgoslings.com.

Customers stay on the ordering screen while staff adjust settings from a phone or laptop.

Help button

Customers tap Help to see up to three staff contacts (name and phone number) in an in-app popup.

  • The iPad does not place phone calls, start FaceTime, or open the Phone app.
  • Configure contacts in Staff settings under Help contacts.
  • At least one valid phone number (7+ digits) is required before the kiosk opens for orders.

Square Stand and USB

If the iPad disconnects from Square Stand after a sale, supervised iPads may have USB Restricted Mode enabled. Allow wired accessories while the device is locked (Apple Configurator restrictions profile). On the iPad, check Settings → Privacy & Security → Wired Accessories.

Staff settings also shows Stand USB status when relevant.

Kiosk lock (Single App Mode)

For a dedicated kiosk, install Store Kiosk on a supervised iPad and use Apple Configurator to enable Single App Mode for com.ryansgoslings.kiosk. Apply a Square Stand USB restrictions profile first if you use a Stand.

For a quick test without MDM, iOS Guided Access can lock the app temporarily.

Common questions

The app says setup is incomplete

Confirm you have accepted deployment terms, saved at least one Help contact with a phone number, and entered a complete Square Application ID, Location ID, and access token. Tap Save, then refresh the catalog.

Catalog is empty or will not refresh

  • Verify your access token has ITEMS_READ and is for the same environment (Sandbox vs Production) selected in settings.
  • Confirm items exist in that Square location’s catalog.
  • Check network connectivity on the iPad.

Payment fails or reader is not found

  • Ensure Location permission is allowed when prompted (required by Square).
  • For Sandbox testing, use the mock reader in staff settings or connect a supported Square reader.
  • For Production, confirm your application signature is registered in the Square Developer Dashboard for bundle ID com.ryansgoslings.kiosk.
  • For Square Stand issues, see Square Stand and USB above.

Customers cannot reach anyone from Help

Add or update Help contacts in Staff settings. Empty name fields show as “Contact.” The iPad only displays numbers; it does not dial.

I forgot the staff PIN

There is no remote PIN reset. If you cannot enter staff settings, remove and reinstall the app to clear local settings and keychain entries, then configure the kiosk again. You will need to re-enter Square credentials.

Is Store Kiosk for unattended vending?

No. Store Kiosk is for self-service during business hours while someone from your business is on the property and available to help. It is not for after-hours public access or unattended roadside vending.

What Ryan’s Goslings does not provide

  • We do not operate a Store Kiosk cloud service or store your Square credentials on our servers.
  • We do not provide Square merchant account support, chargeback handling, or payment processing support.
  • We do not remote-access your iPad.

Configuration and order data stay on the device and in your Square account according to Square’s policies.

Updates and feedback

App updates are delivered through the App Store. If you have feature requests or bug reports, email us with steps to reproduce and screenshots if possible.