🚀 Now in Phase 3A - Production Ready with Advanced Features
Troubleshooting

Troubleshooting

Common issues and solutions for the Abbababa platform.

API Issues

Authentication Errors

Error: "Invalid API key"

  • Verify your API key is correct (copy-paste from dashboard)
  • Check that you're using the header X-API-Key (not Authorization)
  • Ensure there are no extra spaces or newlines in the key

Error: "API key expired"

  • API keys don't expire, but you may have revoked it
  • Generate a new key from your dashboard

Rate Limiting

Error: "Rate limit exceeded"

You've hit your tier's request limit. Solutions:

  • Free tier: Wait until daily reset (midnight UTC)
  • Pro tier: Upgrade to higher tier or pay-per-use
  • Enterprise: Contact support if you're hitting limits

Best practice: Implement exponential backoff:

import time
 
def api_call_with_retry(url, headers, max_retries=3):
    for i in range(max_retries):
        response = requests.post(url, headers=headers)
        if response.status_code != 429:
            return response
        time.sleep(2 ** i)  # 1s, 2s, 4s
    raise Exception("Rate limit exceeded")

Integration Issues

Shopify Connection Failed

Products not syncing

  1. Verify cart permalinks are enabled in your Shopify settings
  2. Check that product visibility is set to "Online Store"
  3. Ensure your API credentials are correct

Cart links not working

  • Verify the cart permalink format: https://yourstore.com/cart/VARIANT_ID:QUANTITY
  • Test the link manually in your browser
  • Check that the variant ID is correct

WooCommerce Issues

Connection timeout

  • Verify your WooCommerce REST API is enabled
  • Check firewall settings aren't blocking our IP addresses
  • Ensure SSL certificate is valid

Products missing

  • Check product status is "Published" (not "Draft")
  • Verify stock status is "In Stock"
  • Confirm product has a price set

Payment Issues

Commission Not Tracking

Sales not showing in dashboard

  • Verify the referral was within 7-day attribution window
  • Check that the sale was completed (not abandoned cart)
  • Ensure the customer used the provided cart link

Commission amount incorrect

  • Verify your subscription tier (commission rates vary)
  • Check if any discounts or coupons affected the sale price
  • Review the commission calculation formula

Billing Problems

Payment declined

  • Update your payment method in Stripe
  • Check for sufficient funds or credit limit
  • Verify billing address matches card

Unexpected charges

  • Review your subscription tier and usage
  • Check commission breakdown in billing history
  • Contact support for detailed invoice

Performance Issues

Slow API Responses

Search taking too long

  • Reduce limit parameter (default: 10, max: 100)
  • Use more specific queries to reduce result set
  • Consider caching frequently searched terms

Timeout errors

  • Increase client timeout to 30 seconds
  • Implement retry logic for transient failures
  • Use batch endpoints for bulk operations

Database Connection Errors

These are rare but can happen:

Data Issues

Product Data Incorrect

Outdated information

  • Product sync runs every 4 hours
  • Force sync from merchant dashboard
  • For real-time updates, use webhooks

Missing images or descriptions

  • Verify images are publicly accessible URLs
  • Check that descriptions aren't empty in source system
  • Ensure character encoding is UTF-8

Still Need Help?

If your issue isn't listed here:

  1. Check our status page: status.abbababa.com (opens in a new tab)
  2. Email support: support@abbababa.com
  3. Include:
    • Your merchant/agent ID
    • Error messages (full text)
    • Steps to reproduce
    • Timestamp of the issue

Response time: < 24 hours for all support requests.

Merchant GuideFAQ