White Label Client Steps: iOS

White Label Client Steps: iOS

Please use Chrome, Firefox, or Safari to complete these steps as Internet Explorer has been known to have issues.
Set up requires an Apple Device connected to the Account created below for Two-Factor authentication. A Mac / iTouch / iPhone / iPad are required to enable 2FA and complete enrollment.

1. Signing In / Creating an Apple Developer ID


Navigate to the Apple Developer account screen and click on the Create Apple ID button to create a new Apple ID, or fill out the form and click Sign In if you have an Apple ID already. 

If creating a new Apple ID account, you will receive an email with a verification code you will need to enter after filling out the form. Sign in with the newly created account.
Be sure to fill out the Create Account form correctly as Apple will verify all of the information. 

When creating an account for your organization, keep in mind this email will be used to get notifications from Apple and Freshop about License Agreement updates, Tax Updates, and other agreements that may prevent pushing new versions of the app from being uploaded. This account will be the Team Leader and need to be accessible in order to handle important operations.

If the Team Leader fails to agree to the latest Apple Developer Program License agreement (when the notification email is received), or yearly payment fails, the app will be pulled from the App Store. 


2. Joining the Apple Developer Program


On this screen, at the bottom of the page you will see a link to Join the Apple Developer Program.

On this new screen, there is a link that will take you to the enrollment page to join the Apple Developer Program .
On this new screen we learn what we need to do to enroll as an organization:
You need to enroll as a Company / Organization. Accidentally enrolling as In-House / Enterprise will not give you access to App Store Connect.
Note: in order for the Work Phone Number and Work Email to be valid in the form, it has to be a non-mobile number and email from your company domain.
(NOT: @gmail, @yahoo, or other common providers).

Enrolling as an Organization
To enroll your organization, you’ll need an Apple ID as well as the following to get started:
  • A D-U-N-S® Number
Your organization must have a D-U-N-S Number so that we can verify your organization’s identity and legal entity status. These unique nine-digit numbers are assigned by Dun & Bradstreet and are widely used as standard business identifiers. You can check to see if your organization already has a D-U-N-S Number and request one if necessary. They are free in most jurisdictions. Learn more
  • Legal Entity Status
Your organization must be a legal entity so that it can enter into contracts with Apple. We do not accept DBAs, fictitious businesses, trade names, or branches.
  • Legal Binding Authority
As the person enrolling your organization in the Apple Developer Program, you must have the legal authority to bind your organization to legal agreements. You must be the organization’s owner/founder, executive team member, senior project lead, or have legal authority granted to you by a senior employee.



When we are certain that we have all of the information we need to proceed, click on the Start Your Enrollment button on the bottom to proceed.

On this next screen click on the Entity Type drop-down, and select the  Organization / Company option, and then click Continue on the bottom.
If Two Factor Authentication is not set up on the account, it needs to be enabled before enrollment can begin. Click on the support page to find more information on enabling 2FA.

https://support.apple.com/en-us/HT207198
On this screen you will select the appropriate Authority, and fill out the Organization Information.

Be sure that all of this information is correct as Apple will verify it.

This step can take 2-4 weeks to complete, and Apple may contact you for any missing / incorrect information. 
Once enrollment is complete it is necessary to purchase the Apple Developer License. Go back to the Apple Developer homepage and sign in.

After filling out the form you will need to Accept a license agreement, and will get presented with an option for Automatic Renewal. Select this option if you want to automatically renew every year.

 


After reviewing the information and accepting the license agreements you need to input the  Billing Information.
Click Continue and accept the Terms and Conditions.

On the following screen you have one last chance to verify the Billing Information. Once everything is verified and all of the information is correct, click on  Place Order Now to finish the transaction.
This step can take up to 48 hours to complete.

3. Accessing App Store Connect


Apple will take some time to process the information you have provided in Step 2. Once verified and accepted, you will receive 2 emails. The first one is an email thanking you for joining the Apple Developer Program. The second email you receive will give you access to the App Store Connect Portal.
Once you have access to the App Store Connect Portal, Sign In with your Apple Developer Credentials from Step 1.

4. Invite Freshop as a Team Member

Next, you will need to invite app@freshop.com   along with your project manager to App Store Connect.
The App Store Connect account should be given the role of App Manager, and permission to create certificates, identifiers, and profiles.
Navigate to App Store Connect , and Sign In.


Click on Users and Roles.

If after logging in you are on the app screen, you can get to Users and Roles by selecting the drop-down in the top left:


Click the + button to create a new user.

Fill in Freshop for the First Name, Team for the Last Name, and app@freshop.com for the Email.

 

Select the role of App Manager.

Check the checkbox under Developer Resources. This gives Freshop the ability to create development and distribution Certificates.


Click Invite to complete the invitation process for App Store Connect.
Role should be set to  App Manager in order to set up the app and push updates.
The checkbox for Developer Resources should be checked.
Invite Additional Users: If there are any other users you would like to have access to Test Flight you can repeat the process above and add more users with relevant roles.

5. Test Flight email for testing your App (iOS)

On your iOS Device go to the App Store and download the TestFlight app.

When your App is ready, you will receive a TestFlight invitation via email.
Open the email on your iOS device, as it has a link to redeem the app in the TestFlight App.

Tap on the View In TestFlight link to open the TestFlight app and redeem the invite.

If you open the link on a desktop computer instead of an iOS Device, it will show a webpage with instructions on how to download the TestFlight app and have a redeem code on the bottom.

If you have a Redeem Code, open the TestFlight app and tap Redeem in the top right and enter the code.
Don’t See the App after accepting the invite?
Try refreshing the screen by dragging / pulling the screen down until the spinning icon appears.

If no app is still showing, bring up the open apps screen by pressing the home button twice, or if your device has no home button, slowly drag up from the bottom until all of the open apps appear, and let go. Then swipe the TestFlight app up to kill the running process.

Relaunch the TestFlight app.
Once you’ve approved the App, your project manager will trigger its push to production.

6. Generate an App Store Connect API Key

Login as Account Owner to App Store Connect
Navigate to Users and Access > App Store Connect API > Keys
Select the + symbol to open the Generate API Key dialog
Name: Freshop
Access: Admin
Select: Generate

In the newly created row, select Download API Key

Send an email to app@freshop.com with the following information
      Attach the API Key (*.p8) file downloaded in the previous step
      Copy and include the Issuer ID
      Copy and include the Key ID


Updated: 23Nov2021

    • Related Articles

    • Freshop White Label App Overview

      Freshop clients can choose to have their own store branded app. Shoppers may use the camera to scan barcodes to add to their list or check items off their list while shopping in the store*. Freshop will set up the app in both iOS and Android.  To get ...

    • White Label Client Info

      The following information will need to be provided to Freshop once it has been decided that a White-Label App is desired. Your project lead will provide a sheet to be filled out which our app team will use to complete the Android and iOS setup. ...

    • Printing Bag Tags with the Freshop for Stores App-iOS

      1. From the order details screen tap the 3 dots in the top right corner. 2. From the Change Order Status dialog tap the Print Labels button. Before printing for the first time, make sure your Print Settings are configured by tapping on the Settings ...

    • Freshop for Stores App (iOS): App No Longer Loading (for an older device) - NEW

      If you are using an older iOS device that was working but is now not loading the Freshop for Stores App - you can try this workaround. Please keep in mind that Apple does stop supporting older devices and operating systems ...

    • Store Specific Slider Guide

      Overview Learn how to create a new group and then assign one or more stores to the Group and then associate each banner to a group(s). How to create a store group 1. Sign into your store’s WordPress site. 2. On the left navigation, locate and select ...