← Back to Support Center

Troubleshooting Guide

Common issues and solutions for merchants and AI agents using the Abba Baba platform.

API Issues

Authentication Errors

401 Unauthorized - Invalid API Key

Error: 401 Unauthorized - Invalid API Key
Cause: API key is missing, incorrect, or expired.
Solution:
  • Verify your API key format (should start with "aba_")
  • Check that the key is included in the X-API-Key header
  • Generate a new API key if the current one has expired

403 Forbidden - Rate Limit Exceeded

Error: 429 Too Many Requests
Cause: You have exceeded your API rate limits.
Solution:
  • Implement exponential backoff in your retry logic
  • Check rate limit headers in the response
  • Consider upgrading your plan for higher limits
  • Cache responses when possible to reduce API calls

Search API Issues

Empty Search Results

Symptoms: API returns 200 OK but with zero results.
Solutions:
  • Try broader search terms or remove restrictive filters
  • Check spelling and try synonyms
  • Use semantic search with natural language queries
  • Verify filters are not too restrictive (price, category)

Slow Search Response

Symptoms: Search requests taking longer than 5 seconds.
Solutions:
  • Reduce the number of results requested (limit parameter)
  • Simplify complex filter combinations
  • Implement caching for repeated queries
  • Use pagination for large result sets

Merchant Issues

Product Sync Issues

Products Not Appearing in Search

Common Causes:
  • Recent product uploads may take 5-10 minutes to index
  • Missing required product information (title, description, price)
  • Product marked as out of stock or inactive
  • Category mapping issues
Solutions:
  • Wait 10-15 minutes after upload and try searching again
  • Check that all required fields are populated
  • Verify product status is set to active/in-stock
  • Contact support if issues persist beyond 30 minutes

Inventory Sync Delays

Issue: Stock levels not updating in real-time.
Solutions:
  • Check your platform integration settings
  • Verify webhook endpoints are responding correctly
  • Use manual sync option in merchant dashboard
  • Review integration logs for error messages

Payment & Commission Issues

Missing Commission Payments

Check:
  • Payment method on file is valid and current
  • Minimum payout threshold has been reached ($50)
  • Sales have completed return/refund period (30 days)
  • Bank account details are correct and verified

Incorrect Commission Calculations

Remember:
  • 5% commission is calculated on net sale amount
  • Shipping costs are excluded from commission calculation
  • Taxes and discounts affect commission calculation
  • Returns and refunds reverse commission payments

General Issues

Account Access Issues

Cannot Access Merchant Dashboard

Solutions:
  • Clear browser cache and cookies
  • Try accessing from an incognito/private browser window
  • Disable browser extensions that might interfere
  • Check if your account email needs verification
  • Reset your password if needed

API Key Generation Issues

Requirements:
  • Account must be verified and in good standing
  • Must have completed merchant onboarding
  • Payment method must be on file
  • Account type must support API access

Platform Performance

Slow Page Load Times

Troubleshooting:
  • Check your internet connection speed
  • Try accessing from a different network
  • Clear browser cache and restart browser
  • Check our status page for any ongoing issues
  • Contact support if issues persist

Still Need Help?

If you cannot find a solution to your issue in this guide, our support team is ready to help.

Support Hours

Email Support: 24/7 response within 24 hours
Priority Support: Business hours (9 AM - 6 PM PST)