As a Riwaya seller, if you are running a successful online business on Shopify, integrating your Shopify store with Riwaya is a winning choice to take your business to the next level.
Riwaya offers a unique marketplace for Muslim-owned businesses and ethically minded entrepreneurs, which can help you reach a wider targeted faith aligned audience.
In this detailed guide, we'll walk you through how to sync your Shopify store to Riwaya, from start to finish, so you can start selling seamlessly across platforms. Whether you're tech-savvy or new to integrations, this tutorial is designed to simplify the process.
Why Connect Your Shopify Store with Riwaya?
Integrations are a valuable tool that can help you grow your e-commerce business. When you Connect your Shopify store to Riwaya, the two platforms can share information, like your products, stock, and orders, automatically. This saves you time and makes your work easier.
Before we jump into the technical steps, it's important to understand why syncing your Shopify store to Riwaya matters:
a. Expand Your Reach: Access Riwaya's engaged and growing Muslim community without managing two separate stores.
b. Real-Time Inventory Sync: Automatically update your product listings, stock levels, and orders across both platforms.
c. Save Time: Avoid double entry and manual errors by syncing products, inventory, and orders instantly.
d. Unlock More Sales Opportunities: Tap into a niche audience looking specifically for ethical, halal, and Muslim-owned brands.
In short, you can set your business up for scalable growth by integrating your Shopify store with Riwaya.
Step-by-Step Guide to Connecting Your Shopify Store to Riwaya
Follow these steps to connect your Shopify store to Riwaya:
Step 1: Log in to Your Shopify Store
First of all, head over to your Shopify admin panel and login using your credentials.
Tip: Make sure you have the necessary admin permissions to create and manage apps inside your Shopify store.
Step 2: Navigate to Apps and Sales Channels
Once logged in, go to 'Settings' in your Shopify dashboard and then click on 'Apps and Sales Channels'.

Step 3: Develop an App for Riwaya
Inside the Apps and Sales Channels page:
a. Click the ‘Develop Apps’ button.

b. Then select ‘Create an App’.

Step 4: Enter a Name for Your App
In the pop-up window, give your app a descriptive name (e.g., Riwaya Integration, Riwaya app, or something like that). After entering the name, click 'Create app'.

Step 5: Configure API Scopes
Next, you’ll need to assign the proper permissions for the app.

Under the ‘Configure Admin API Scopes’ section, select the following scopes to grant Riwaya access to the necessary data:
- read_product_listings
- read_products
- read_inventory
- read_orders
- write_orders
- read_fulfillments
- write_fulfillments
- read_assigned_fulfillment_orders
These permissions ensure Riwaya can sync your products, inventory, and orders correctly.
Step 6: Save Your Scopes
After you have selected all the required scopes, click the 'Save' button.

Step 7: Install the App
Now it’s time to install the app inside your Shopify store:
a. Go to the ‘API Credentials’ tab under the same app configuration page.

b. Click ‘Install’.

Step 8: Retrieve Your Access Token
Once the app is installed, your 'access token' will be displayed.
Important: To protect your data, you’ll only be able to reveal your Admin API token once. So copy this token and store it securely. You'll need it to connect to Riwaya.

Step 9: Enter Token and Store URL on Riwaya
a. Paste the copied token into the designated field on the Riwaya onboarding form or vendor admin panel.
b. Enter your Shopify store URL. Make sure there are no extra spaces before or after the URL and token. Then, save the information.

Post-Connection Steps: Setting Up Your Riwaya Integration
Once your Shopify store is connected, you'll need to configure a few more settings on Riwaya to ensure your products are displayed correctly and orders are processed smoothly.
1. Map Categories
Match your Shopify product categories to the corresponding categories on Riwaya. This ensures your products are easily discoverable by customers.
Note: If you can’t find a matching category, select the ‘Unmapped Category’ option. The Riwaya team will review it and help you place your product in the right category.

2. Map Products
Select the specific products you want to sync with Riwaya. You may not want to list all your products on the platform.
Note: After syncing, it may take 2 to 3 working days for your products to be reviewed and approved by the Riwaya team.

3. Sync Data
Initiate a data sync to transfer your product information (descriptions, images, prices, inventory) from Shopify to Riwaya.
Important: You can edit your data anytime, and it will automatically sync every hour.

Common Mistakes to Avoid during Setup
a. Incorrectly Copying the Access Token: This is a frequent error. Double-check that you have selected and copied the entire access token from your Shopify app's API credentials. Even a single missing character will prevent a successful connection.
b. Entering the Wrong Shopify Store URL: Ensure you are using the correct URL for your store. Always use the full URL including `https://`. Typos are common here, so verify it carefully.
c. Skipping Essential API Scopes: Failing to select all the necessary API scopes during the app creation in Shopify will limit the data Riwaya can access, leading to incomplete syncing or functionality issues. Double-check against the list provided.
d. Not Reviewing Riwaya's Guidelines: Familiarise yourself with Riwaya's specific guidelines & conditions for product listings, categories, and any other platform-specific requirements to ensure your listings comply.
Note: Still stuck? Reach out to Riwaya’s support team - they’re always happy to assist.
Conclusion
If you’re a Shopify user, don’t miss out on Shopify Riwaya integration. By following these steps, you can successfully sync your Shopify store with Riwaya and expand your business within the Muslim community.
With automated syncing of products, inventory, and orders, you save time, reduce errors, and gain visibility where it matters most. Remember to regularly update your product information and monitor your sales performance to optimise your strategy.