REST API v1

Buyology Backend API

E-commerce REST API powering products, stores, payments, authentication, and more.

Server Online
Base URL: /api
Auth: JWT + Cookie

API Modules

๐Ÿ”

Authentication

JWT-based auth with refresh tokens, OTP verification, and OAuth2 social login.

Sign Up / In OTP Email Google OAuth Refresh Token Password Reset
๐Ÿ“ฆ

Products

Full product catalog with categories, brands, variants, specs, media, and accessories.

Categories Brands Variants Global Specs Quick Delivery
๐Ÿช

Stores

Multi-store support with locations, store-level products, and country management.

Store CRUD Locations Store Products Countries
๐Ÿ’ณ

Payments

Paymob integration supporting card payments, Tabby BNPL, and Tamara installments.

Paymob Card Tabby Tamara Webhook
๐Ÿ›’

Cart

User cart management โ€” add, update, remove items and retrieve cart contents.

Add Item Update Qty Remove Item Cart Summary
โญ

Reviews & Q&A

Product reviews with ratings and a customer Q&A system with admin moderation.

Reviews Ratings Questions Admin Moderation
๐Ÿ“–

Stories

Instagram-style stories with media uploads, translations, and view tracking.

Create Story Media Upload Translations View Tracking
๐Ÿ‘ค

Users

User profiles, saved addresses, roles, and fine-grained permission management.

Profiles Addresses Roles Permissions