Customer Onboarding Guide

    Buddy Native Mobile App — iOS Onboarding Guide

    Buddy builds and maintains a native iOS app for your dispensary, published in the App Store under your business name. Apple requires that dispensary apps live in the retailer's own Apple Developer account — so the one thing we need from you is that account, plus a few app assets. This guide walks you through everything. Your part takes about 15 minutes of active work; Buddy handles the rest.

    You

    Create your Apple Developer account, invite Buddy, send us your app name and icon.

    Buddy

    App creation, build, App Store submission, review handling, and every future update.

    01

    Step 1: Create Your Organization Apple Developer Account

    Enroll as an Organization, not an Individual. Individual accounts publish the app under a person's name and cause onboarding delays. There is no way to convert later without re-enrolling.

    Before enrolling, make sure you have:

    • A legal business entity (LLC, corporation, etc.) that can enter into contracts — Apple verifies this.
    • A D-U-N-S Number — a free nine-digit business identifier Apple uses to verify your organization. Most established businesses already have one. Check or request one free with Apple's D-U-N-S lookup tool (allow up to 5 business days).
    • An email address on your company's domain (not Gmail).
    • A publicly available website on a domain associated with your business.
    • An Apple Account with two-factor authentication enabled, registered with your legal first and last name.
    • Legal binding authority — the person enrolling becomes the Account Holder and must be an owner, executive, or senior employee with authority to sign for the organization.

    When you're ready, enroll at developer.apple.com. Choose Organization as your entity type, enter your legal entity name, D-U-N-S Number, address, and website, and pay the $99 USD annual membership fee. Apple's verification typically takes a few days, and they may call the number on your D-U-N-S record to confirm details — respond promptly to keep things moving.

    Annual renewal matters. Your membership renews yearly at $99. If it lapses, Apple removes your app from the App Store until it's renewed. Enable auto-renewal and keep your payment method current.
    Watch for Apple legal notices. Apple emails the Account Holder when new legal agreements are available. These must be accepted within 30 days (sometimes less) — unaccepted agreements freeze the account and block app updates.
    02

    Step 2: Invite Buddy & Enable API Access

    Once your enrollment is approved, add Buddy as an Admin to your developer account:

    1. Sign in to App Store Connect at appstoreconnect.apple.com with your Account Holder Apple Account.
    2. Go to Users and Access.
    3. Click the "+" button to invite a new user.
    4. Invite buddy@hellobuddy.app with the Admin role and access to all apps.
    5. Invite support@hellobuddy.app with the Admin role and access to all apps.

    Then enable App Store Connect API access so our systems can maintain your app:

    1. In Users and Access, select the Integrations tab.
    2. Under App Store Connect API, click Request Access.
    3. Review the terms, check the confirmation box, and click Submit.
    Why Buddy needs Admin access: we generate certificates, create your app record, upload builds, and respond to App Store review on your behalf. You remain the Account Holder at all times — Buddy never needs your login. Please don't remove Buddy's accounts; if removed, we can't assist with onboarding or fix issues that come up.
    Keep your team list small. If you add your own staff, most should be at the "Customer Support" level — additional users should not manage certificates and identifiers. You're responsible for users you add; destructive actions by your users can't be recovered by Buddy.
    03

    Step 3: App Creation — Name, Icon, and Description

    Email the following to support@hellobuddy.app. Once received, Buddy creates the app in your developer account on your behalf, sets the age rating, and configures app privacy settings — we'll confirm when it's done.

    App Name

    Shown in the App Store and under the icon on customers' phones. Cannot be changed after launch. Max 30 characters.

    App Icon

    1024 × 1024 px and 512 × 512 px. Square, 90° corners (Apple rounds them automatically — don't pre-round). No transparent pixels; fully opaque background. PNG. Note: any future icon change requires a new submission and Apple review.

    App Description

    Concise, benefit-focused copy about what customers can do — browse your menu, order ahead, earn rewards. Never mention vaporizer or vape products anywhere in the description, screenshots, keywords, or app — Apple will reject it.

    App Keywords (4–5)

    Custom to your store, e.g. "cannabis, dispensary, cannabis delivery, [YOUR STATE] cannabis". Apple caps the keyword field at 100 characters.

    04

    Step 4: Preview Your App with TestFlight

    Before your app goes live, you'll preview it with TestFlight — Apple's official beta testing app. We'll send you an invite to your email; install TestFlight from the App Store, accept the invite, and you can run the full app on your own phone. Tell us anything you'd like adjusted before we submit to Apple.

    05

    Step 5: Apple Review

    Buddy submits your app to Apple for review. Cannabis apps get extra scrutiny — Apple only allows cannabis commerce from licensed, legal businesses, geo-restricted to jurisdictions where it's legal. Buddy configures all of this for you; have your license number handy in case Apple asks for proof of licensure.

    If accepted

    Your app goes live in the App Store.

    If rejected

    Buddy works directly with Apple on the feedback and resubmits. If it's rejected again, we keep working with Apple until approval — occasionally we'll need your sign-off on revised copy or assets.

    Typical timeline from invite to live app: 2–4 weeks, driven mostly by Apple's review queue.

    New Versions and App Updates

    After launch, Buddy maintains your app. New versions ship with Buddy-provided "What's New" notes and are subject to Apple review each time — Apple can occasionally reject something previously approved; we handle mitigation and will loop you in only if copy or asset changes need your approval.

    You choose your release preference (changeable anytime):

    Automatic (recommended)

    Approved versions go live as soon as Apple approves them.

    Manual

    Approved versions wait until you log in to App Store Connect and release them yourself.

    Frequently Asked Questions

    Questions? We'll walk you through it.

    We onboard every dispensary personally. Reach out any time — we usually reply the same business day.

    Learn more about Buddy features or how we power dispensary retailers and cannabis brands. The app can be launched for both.

    Copy Copy

    See why Buddy is changing Cannabis Technology

    Explore how the biggest brands & retailers are using Buddy

    See why Buddy is changing Cannabis Technology

    Explore how the biggest brands & retailers are using Buddy