Store Connection Guide

Connect your marketplace stores to Revenuealot to unlock powerful analytics, automation, and optimization tools. This guide covers connecting Takealot and Makro stores.

Security & Data Privacy

Your data security is our priority. All store credentials and data are encrypted and stored securely.

🔒 Encryption: All data is encrypted in transit and at rest.
🔑 Credentials: We only request these details because many e-commerce platforms in South Africa do not provide sufficient API access.
🛡️ Access Control: Only authorized team members can view store data.

Connect Takealot Store

Overview

Connecting your Takealot store allows Revenuealot to sync via API and intelligent collection:

📦 Product Data & Inventory: Real-time sync of listing details and stock levels.
💰 Sales & Revenue Metrics: Comprehensive sales dashboards and revenue analysis.
📊 Order & Return Info: Automatically pull historical and real-time orders and returns.
🎯 Ad Campaign Data: Track ROAS and campaign performance.
⭐ Product Reviews & Ratings: Monitor customer feedback and rating trends.

Step 1: Get Your Takealot API Credentials

Access API Key Management
- Visit Takealot Seller API Key Management
- Sign in with your seller credentials if prompted
Generate API Key
- Click “Generate New API Key” or create a new key
- Copy the API Key (you won’t be able to see it again!)

Step 2: Add Store in Revenuealot

Navigate to Store Settings
- Go to Dashboard → Settings → Stores
- Click “Add Store” and select Takealot
Enter Store Credentials

You will need to provide the following information to establish a full connection:
- Store Name: Give your store a recognizable name.
- Seller ID: Your Takealot Seller ID.
- Login Email/Username: The email address or username you use to log in to the Takealot Seller Portal.
- Login Password: The password for your Takealot Seller Portal account.
  - API Key: The API Key you generated in Step 1.
⚠️
Why do we need your login credentials? Takealot’s API does not cover all functionalities required for advanced analytics and automation. We use your credentials to securely access the necessary data that isn’t available via the public API. Your credentials are encrypted and stored securely.
Save and Connect
- Click “Connect”
- The system will verify your credentials and start the initial sync.

Connect Shopify Store

Overview

Shopify connections use OAuth to grant Revenuealot access to your store. To start the connection we only need your store’s permanent Shopify domain (the original *.myshopify.com domain). If you have a custom domain (for example www.example.com), please use the your-store.myshopify.com domain instead — this permanent domain will always point to your store even if you later add a custom domain.

We only need the store prefix. When adding a Shopify store in Revenuealot, enter the part before .myshopify.com (for example, enter your-store for your-store.myshopify.com). The UI will append .myshopify.com for you.

Step 1: Find your permanent Shopify domain

Open Shopify Admin
- Log in to your Shopify admin dashboard.
Go to Domains
- Navigate to Online Store → Domains (or Settings → Domains in some admin layouts).
- Look for the domain that ends with .myshopify.com — this is your permanent Shopify domain (e.g. your-store.myshopify.com).
If you only see a custom domain
- Click the “View store” or “Manage” link for your domain; the myshopify domain is usually listed as the original Shopify domain in the domains panel.

You may see more than one *.myshopify.com domain listed (for example if the store’s myshopify domain was changed in the past). The entry marked Primary is the current myshopify domain; older *.myshopify.com domains are usually retained and will redirect to the primary. Any listed *.myshopify.com domain identifies your store for connection, but if you’re unsure, prefer the one marked Primary.

Step 2: Add Shopify store in Revenuealot

Navigate to Store Settings
- Go to Dashboard → Settings → Stores
- Click “Add Store” and select Shopify
Enter your Shopify store prefix
- In the store domain field, enter only the prefix (the part before .myshopify.com). Example: for your-store.myshopify.com enter your-store.
Click Connect
- You will be redirected to Shopify to review and approve the requested permissions. Complete the OAuth flow in Shopify to finish the connection.

⚠️

Common pitfalls: Do not include https://, www., or a trailing slash. Enter the store prefix only (no https:// and no .myshopify.com).

Connect Makro Store

Overview

Makro integration uses a hybrid model (Credentials + Email Forwarding) to provide:

🏪 Product Listing Management: Manage listings directly using your seller credentials.
📈 Performance Tracking: Track overall store performance based on parsed data.

Step 1: Add Store in Revenuealot

Navigate to Store Settings
- Go to Dashboard → Settings → Stores
- Click “Add Store” and select Makro
Enter Store Credentials
- Select Makro in the drop down list
- Enter your login credentials

Step 2: Configure Email Auto-Forwarding

To ensure uninterrupted integration with your Makro account, you must set up permanent email auto-forwarding from the email address linked to your Makro account. This is required because Makro does not provide enough API access for automation, so our system relies on receiving account-related emails directly.

Configure Auto-Forwarding
- Log in to the email account associated with your Makro seller account.
- Set up a rule to auto-forward all emails from Makro to:
  
  RD@revenuealot.com
Setup Guides for Common Email Providers:
- Gmail: Forward emails automatically
- Outlook: Microsoft 365: Set up inbox rules for forwarding
- Lark: Set up mail forwarding
- Other: Search for “auto-forwarding” in your email provider’s help center.

Troubleshooting

Takealot Connection Issues

Issue: “Validation Failed” or “Invalid API Credentials”

Possible Causes:

API Key does not match the User ID.
API Key has expired or been revoked.
Incorrect User ID entered (ensure it is User ID, not Seller ID).

Solutions:

Log in to Takealot Seller Portal and regenerate the API Key.
Ensure you copy the full API Key string.
Verify the User ID is correct (usually visible on the API Key generation page).

Makro Connection Issues

Issue: “Makro Account Validation Failed”

Cause:

Incorrect username or password.
Makro portal is undergoing maintenance.

Solutions:

Try logging into the Makro Seller Portal directly to confirm credentials are valid.
Ensure no extra spaces are entered.
If you changed your Makro password, update credentials in Revenuealot.

Issue: “Email Forwarding Not Detected”

Cause:

The test email sent by the system was not forwarded back to Revenuealot.
Forwarding rules are incorrect or delayed.

Solutions:

Check your email settings to ensure the forwarding rule is enabled and points to RD@revenuealot.com.
Check your spam folder.
Ensure the forwarding rule applies to all emails from Makro, not just specific types.

General Connection Tips

✅ Best Practices:

Use a stable internet connection when connecting stores.
Do not refresh the page during initial sync.
Keep API credentials secure and never share them.
If you change your password, re-test the connection.

❌ Avoid These Errors:

Sharing API keys publicly or with unauthorized team members.
Using the same API key across multiple platforms if not supported.
Ignoring “Connection Lost” warnings.

Need Help?

If you encounter any issues connecting your stores, please reach out to our support team at support@revenuealot.com.

Getting Started Multi-Store Dashboard