Facebook Account Quick Registration / Member Login (New)

Click this link to enter Meta for Developers and log in with your personal Facebook account. Go to [My Apps] > [Create App].

*Note: The Meta for Developers app is bound and created under a personal account. To avoid potential conflict of access permission in your company’s internal personnel, you are recommended to use your company’s Facebook personal account for convenience. As per Step 12, add your store's personnel-in-charge as app administrator for subsequent maintenance and management.

If you haven’t created any app before this, upon clicking My Apps, you will see a page that says "No apps yet" to invite you to create your first app.

 

Step 2. Create a Facebook app

After clicking Create App, you will be asked, "Which use case do you want to add to your app?" Select Authenticate and request data from users with Facebook Login.

 

Select whether you are building a game.

Upon completion, click Create app.

• App name (required): It is recommended to enter a "Store or Brand name".
• App contact email: It will be automatically filled in with the email address associated with the account.
• Business portfolio: If you have a Meta Business Manager, you can also select a platform via the drop-down menu.

A pop-up window will appear. Re-enter your password, and click Submit to proceed.

Step 3. Add the "Facebook Login" app

In the "Use cases" tab, click the Customize button next to "Authentication and account creation".

 

Then, click Go to quickstart.

Choose Web as the platform for your app.

 

Please input your store's homepage URL in the "Site URL" field, such as "https://www.test123.com" or "https://www.test123.com.tw". Upon completion, click Save and wait for the app to access the URL.

*Note: Please fill in a secure encrypted URL starting with "https://".

 

Step 4. Basic settings

Go to [App settings] > [Basic] and fill in the relevant fields.

1. App domains
2. Privacy policy URL
3. App icon
4. User data deletion
5. Terms of Service URL
6. Category
7. Site URL

1. App domains (Required)

This field requires a total of 2 URLs (naked/root domain & URL including a subdomain). Please follow the instructions below to obtain the URLs and paste them separately. After pasting each URL, press "Enter (Window) / Return (Mac)" on your keyboard. The URL will be displayed in the gray box to indicate a successful input, as shown in the image below.

• If your store applies a "unique URL": https://www.test123.com 
  Please fill in 2 URLs: www.test123.com and test123.com 
  
  
• If your store applies a "free URL": https://test456.shoplineapp.com
  Please fill in 2 URLs: test456.shoplineapp.com and shoplineapp.com

Please change the above links in bold orange to your store URL links. If you are unsure of your store's unique URL or free URL, go to your store's homepage to copy it.

*Note: Please fill in your store's URL instead of the official website URL of SHOPLINE.

 

2. Privacy Policy URL (Required)

The privacy policy is a statement that explains how a website will handle the personal data of its users. Having a disclosed "Privacy Policy" in your store is one of the requirements for payment gateway review, Google ad placement review, and Facebook app review.

First, return to SHOPLINE Admin > [Online Store Design] > [Pages] (see the image below) to obtain the URL of your store's "Privacy Policy" page, and paste it back to the field here.

If you haven't created a Privacy Policy page yet, you can either choose to use the default "Privacy Policy" page (A) or create a new page (B):

i. Use the default "Privacy Policy" page

You can refer to SHOPLINE Sample Store Page to supplement relevant information (please write according to actual regulations and requirements). Once you have completed the setup, fill in the URL into the "2. Privacy Policy URL" field.

• If your store applies a "unique URL," you'll get a URL similar to:
  https://www.test123.com/about/privacy-policy
  
  
• If your store applies a "free URL," you'll get a URL similar to this one:
  https://test456.shoplineapp.com/about/privacy-policy

Please change the above links in bold orange to your store URL links. If you are unsure of your store's unique or free URL, go to your store's homepage to copy it.

*Note: Please fill in your store's URL instead of the official website URL of SHOPLINE.

 

ii. Create a new page

Click on ⊕ Text Page or ⊕ Advanced Page to create a "Privacy Policy" page. For format and content, you may refer to SHOPLINE Sample Store Page (please write according to actual regulations and requirements, and remember to specify the "Data access and deletion" information).

*Note: If your store is currently using 
"Facebook Account Quick Registration / Member Login" 
and has previously provided a descriptive URL with 
"privacy-policy" to Facebook,
please do not delete the old privacy policy page 
to avoid disabling the login feature.
If you want to delete the old privacy policy page 
and shift to the default/new privacy policy page, 
go to Meta for Developers and
pages that contain the old privacy policy
to manually update it with the new URL.

Please ensure that the SEO "Title" of that page includes the words "Privacy Policy" and the "Descriptive URL" contains "privacy-policy" to make it easier for Facebook to identify the page as having relevant privacy-related content. Next, fill in the URL in the "2. Privacy Policy URL" field.

• If your store applies a "unique URL," you'll get a URL similar to this one:
  https://www.test123.com/pages/privacy-policy

• If your store applies a "free URL," you'll get a URL similar to: https://test456.shoplineapp.com/pages/privacy-policy
  

Please change the above links in bold orange to your store URL links. If you are unsure of your store's unique URL or free URL, go to your store's homepage to copy it.

*Note: Please fill in your store's URL instead of the official website URL of SHOPLINE.

3. App icon (Required)

The app icon will appear along with the "Display Name" in the customer login process. SHOPLINE recommends uploading your store's logo or brand icon to fully present your brand and reduce customer concerns about it being a fraudulent or unofficial channel for collecting user data. Facebook requires uploading an image with dimensions between 512 x 512 and 1024 x 1024 pixels and a file size of up to 5MB.

 

4. User data deletion (Required)

Select "Data deletion instructions URL" from the drop-down menu. 

In the "You can also provide a link" field below the drop-down menu, enter your store's homepage URL, like "https://www.test123.com" or "https://www.test123.com.tw". Make sure to fill in a secure encrypted URL starting with "https://".

 

5. Terms of Service URL (Optional)

This URL link will be displayed in the "App Terms" of the Facebook login application window. SHOPLINE recommends editing your store's default page for "Terms and Conditions" and describing your store's service offerings and transaction details based on actual circumstances. Once completed, paste the page URL in this field.

 

6. Category (Required)

Please select the appropriate option from the "Choose a category" drop-down menu based on the type of products or services your store provides. If your online store primarily sells products, it is recommended to choose Shopping.

 

7. Website (Required)

Click Add platform and select Website.

Normally, the system will automatically populate the URL. However, if the field is blank, please re-enter your store's homepage URL, such as "https://www.test123.com" or "https://www.test123.com.tw". Be sure to fill in a secure encrypted URL starting with "https://". Upon confirmation, click Save changes at the bottom right.

 

Step 5. Complete "Facebook Login" settings

In the "Use cases" tab, click the Customize button next to "Authentication and account creation".

 

Then, click Go to settings.

 

Upon entering the page, please refer to the following two points:

i. Switch on designated function toggles

Enable the following 4 toggle switches (ensure that the switches display as "Yes") and compare them to the image below for confirmation.

• Switch on "Client OAuth login"
• Switch on "Web OAuth login"
• Switch on "Enforce HTTPS"
• Switch on "Use Strict Mode for redirect URIs"

 

ii. Enter the link into "Valid OAuth Redirect URIs"

Follow the instructions below to obtain the link and paste it into the "Valid OAuth Redirect URIs" field. After pasting the link, press "Enter (Window) / Return (Mac)" on your keyboard. The URI should turn blue to indicate successful input, as shown in the image below. Once you have completed the setup, click Save changes at the bottom right. Please note that upon submission, double-check if the "Use Strict Mode for redirect URIs" toggle is switched off (displayed as "No"). If it is switched off, you need to switch it back on and click [Save changes] again.

• If your store applies a "unique URL": https://www.test123.com 
  Please paste: https://www.test123.com/users/auth/facebook/callback  
  
  
• If your store applies a "unique URL": https://test456.shoplineapp.com
  Please paste: https://test456.shoplineapp.com/users/auth/facebook/callback

Please change the above links in bold orange to your store URL links. If you are unsure of your store's unique or free URL, go to your store's homepage to copy it.

*Note: Please fill in your store's URL instead of the official website URL of SHOPLINE.

 

Step 6. Check the status of use cases

Go to [Use cases] > [Customize] and click Add next to "email".

 

Ensure that on the "Use case permissions" page, you have two options "email" and "public_profile" available.

*Note: Apart from these two options, do not add any other options here to avoid additional document verification during the business verification process by Facebook. Adding more options may lead to further compliance requirements and potentially impact the business verification process.

 

Step 7. Update API version

Go to [App settings] > [Advanced] and ensure that you are using the latest version of the API. If not, please change it manually.

 

Step 8. Complete business verification

As of 1 February 2023, business verification is required if your app needs advanced-level access. Upon verification, Facebook will automatically update the status of use case permissions.

Go to [Review] > [Verification] and click Start Verification.

*Note: Due to the version difference, there will be 3-4 options under the "Review" tab.

 

Once you've completed verification, a green circle indicating "Verified" will be displayed within the "Business verification" block, which means your store has been successfully verified by Facebook.

 

*Note: If you haven't completed the business verification when the customer quickly registers/logs in with the Facebook account at the storefront, it will display "Some of the permissions below have not been approved for use by Facebook."

 

Step 9. Submit the review

Go to [Review] > [App Review] and you will see the review status as "Draft". Click the Edit button on the right.

Complete all the pre-review steps, and then click Submit for Review.

 

Step 10. Check application status

Check the following information:

• Please ensure the information for the "Privacy policy URL" and "User Data Deletion" is correct.
• Please ensure that the business verification status is "Verified". If not, click Start Verification.
• Go to data handling questions and complete the subsequent steps.

 

Click Review next to "Authenticate and request data from users with Facebook Login".

Return to [Use cases] > [Customize] and the permission status for "email" and "public_profile" should both be "Ready for Live mode."

 

Step 11. Have your App ID and App secret ready

Go to [App settings] > [Basic] and click Show next to "App secret". For account security, the system will require you to re-enter your password. Once entered, "App secret" will be visible. Copy "App ID" and "App secret" and proceed to the SHOPLINE Admin for configuration.

 

Step 12. Return to SHOPLINE Admin for configuration

Path 1

Go to SHOPLINE Admin > [Settings] > [Customer Settings] to switch on the toggle of "Facebook Login."

Paste the "App ID" and "App Secret" into their respective fields. Click on Connect and then click the Update button at the bottom right of the page to save the settings. Your store will now be able to access the Facebook Login feature.

 

Path 2

Go to SHOPLINE Admin > [Channel Integration] > [Facebook] > [Online Store Application] tab. Click Connect on the right side of "Connect to Facebook Developer account." 

Paste the "App ID" and "App Secret" into their respective fields and click Connect.

Switch on the "Online Shop Facebook Login" toggle, and your store is now able to access the Facebook Login feature. 

 

Step 13. Add relevant colleagues as administrators to your Facebook account

You can add relevant personnel from your company as administrators of this app for future maintenance and management.

Go to "Dashboard" > [App Roles] > [Roles], click on Add Administrators on the right side of "Administrators," enter the name, fbid, or username of the person you want to add, and finally click on Submit.

Step 14. Test the Facebook account one-click registration/ login feature

Congratulations on completing the setup! Now, proceed to your storefront to perform the testing.

Go to the registration/ member login page of your store and click on the "Facebook Register/Login" button. A Facebook window will pop up, requesting customers to log in and authorize your app. The app's display name and icon will be shown here on this page.

At this point, customers must authorize the Facebook Login application to access their data in order to use the Facebook Login feature. If customers choose not to grant authorization, they will not be able to use the Facebook Login feature.

*Please be reminded again that as this feature involves many setup steps, should you encounter any issues during the configuration process, feel free to take screenshots of the problematic areas and provide them to SHOPLINE's Online Merchant Success Team. We will assist you promptly in resolving the issues. 

 

2. The Facebook Login button on checkout pages

Please ensure that the "Online Shop Facebook Login" feature has been enabled for your store. For further details, you can refer to Step 11.

Regardless of which path above is chosen, the following pages will display the "Facebook Login" button, and customers will be able to log in directly by clicking this button:

*Notes:

• The setup steps for the Facebook Login button above do not apply to the Shopper App.
  If you wish to show the Facebook Login button on the Shopper App, please refer to Facebook Account Quick Login / Membership Registration | Shopper App 
• Only customers who have registered through Facebook can access the "Log in with Facebook" button.

i. Member Sign up / Sign in page

 

ii. Checkout page in general: Shopping Cart & Customer Info

 

iii. Express checkout page

 

 

Read more

• FAQs and Troubleshooting Methods for Facebook Account Quick Registration / Login