Salla Integration Guide
Connect your Salla store to ZaLinkAI and empower AI agents with full access to the Salla ecosystem.
OAuth 2.0 Authentication
Salla provides a standard OAuth 2.0 flow to authorize third-party applications securely.
Initiate Authorization
Redirect the merchant to Salla's OAuth consent screen with your app_id, redirect_uri, and scopes. Include a state parameter for CSRF protection.
Merchant Approves Access
The merchant reviews requested permissions (products, orders, customers, carts, webhooks) and grants access to their Salla store.
Authorization Callback
Salla redirects to your callback URL with an authorization code. Verify the state parameter matches your original request.
Token Exchange
Exchange the authorization code for access and refresh tokens via Salla's token endpoint. ZaLinkAI encrypts and stores tokens with AES-256.
Platform Capabilities
Everything AI agents can accomplish through the Salla integration.
Product Management
- Full product catalog synchronization
- Inventory tracking and stock alerts
- Product variants and options support
- Image and media asset management
Order Processing
- Create, read, and update orders
- Fulfillment status management
- Return and refund processing
- Order notes and internal comments
Customer Profiles
- Customer data and contact info
- Purchase history and preferences
- Customer group and tier access
- Address book management
Webhook Events
- Real-time order notifications
- Product change events
- Customer activity tracking
- App lifecycle events
Cart & Checkout
- Shopping cart API access
- Secure checkout URL generation
- Coupon and discount application
- Shipping rate calculation
RTL & Localization
- Native RTL interface support
- Arabic-first content handling
- GCC region currency support
- Bilingual product data
MENA Payment Gateways
Salla integrates with regional payment providers popular across the GCC.
Mada
Saudi debit card network, widely used for local transactions.
STC Pay
Mobile wallet by STC, popular for quick payments in Saudi Arabia.
Tabby
Buy Now, Pay Later service available across the GCC region.
Tamara
Installment-based payment solution for the MENA market.
Apple Pay
Contactless payments supported for Salla stores.
Moyasar
Payment gateway supporting multiple Saudi payment methods.
Troubleshooting
Common issues and resolutions for the Salla integration.
invalid_client
App credentials (client_id or client_secret) are incorrect.
Verify your Salla Partner app credentials. Regenerate the secret if needed from the Salla Partner Dashboard.
access_denied
Merchant declined the authorization request.
The merchant must approve all requested scopes. Ensure you only request permissions your app actually needs.
refresh_token_expired
Refresh token has exceeded its validity period.
Request the merchant to re-authorize. ZaLinkAI automatically refreshes tokens 30 minutes before expiry.
rate_limit_exceeded
Too many API requests in a short period.
Implement exponential backoff. Salla allows 100 requests/minute per store. Check X-RateLimit headers.