Stripe billing and subscription
YumKiosk uses Laravel Cashier on top of Stripe Billing to handle owner subscriptions. There are two distinct Stripe relationships happening in your account, and understanding the difference saves a lot of confusion:
- Stripe Connect — your restaurant's own Stripe account, used to charge your customers at the kiosk. Money goes directly to your bank; YumKiosk never touches it.
- Stripe Billing (merchant of record) — YumKiosk's Stripe account, used to charge you for platform usage. This is the one we're discussing on this page.
Plans
Every owner has a plan, picked during signup or changed later from Billing → Plan. As of this writing, the plans are:
- Free trial — $0 for 30 days, capped at 50 agent-hours.
- Starter — $99/month, up to 200 agent-hours included, $0.75/hour overage.
- Pro — $299/month, up to 800 agent-hours included, $0.60/hour overage.
- Custom — negotiated, for chains with 10+ locations.
Hours are pooled across all agents. If you have 3 agents each working 70 hours in a month on the Starter plan, you've used 210 hours and pay 10 × $0.75 = $7.50 in overage on top of the $99 base.
The billing cycle
YumKiosk bills on a calendar-month cycle: invoices are generated on the 1st of each month for the previous month's usage. You're emailed a PDF invoice and a link to the itemized breakdown in your owner panel.
The payment method on file is charged automatically on the 3rd. If the charge fails, you have a 7-day grace period during which your account stays active and Stripe retries with smart dunning. After 7 days of failed charges, your agents are paused from accepting new sessions and an urgent email is sent. Once payment succeeds, everything resumes within minutes.
Managing payment methods
Go to Billing → Payment methods to add or remove cards and bank accounts. You can have multiple methods on file with one marked as default. We support all major credit cards, US ACH, and SEPA direct debit.
Proration
Plan upgrades are prorated immediately. If you upgrade mid-month from Starter to Pro, you're credited for the unused portion of Starter and charged a prorated amount of Pro for the remainder of the month. Plan downgrades take effect at the end of the current cycle — you keep Pro benefits until the 1st, then downgrade.
Trials
New accounts get a 30-day trial with no credit card required. During the trial you can do everything a paid owner can, except you're capped at 50 agent-hours. If you exhaust those hours before day 30, your agents are paused until you add a payment method and select a plan — no charges happen behind your back.
Webhooks
Stripe sends webhooks to https://agent.yumkiosk.com/stripe/webhook for every billing event. We listen for invoice.paid, invoice.payment_failed, customer.subscription.updated, and a few others. These drive the emails and status banners you see in the owner panel. For API consumers integrating with their own billing systems, see the Webhooks page.
Canceling
You can cancel anytime from Billing → Cancel subscription. You'll keep access through the end of the current billing cycle, after which your account is marked closed. Your data is retained for 90 days in case you want to come back; after that it's anonymized per our privacy policy.