{ "info": { "name": "OFROO API - Complete Collection", "description": "Complete API collection for OFROO Platform - Local Coupons & Offers System\n\n## Features:\n- Authentication & Authorization\n- Offers & Categories Management\n- Cart & Orders\n- Financial System (Wallet, Transactions, Withdrawals)\n- Advanced Reporting (PDF & Excel)\n- Roles & Permissions (RBAC)\n- Certificates & Courses\n- Admin Control Panel\n\n## Authentication:\n1. Register/Login to get auth_token\n2. Token is automatically saved after login\n3. All protected endpoints use Bearer token\n\n## Error Handling:\nAll API endpoints return JSON responses for errors:\n- **401 Unauthorized**: Authentication required\n- **403 Forbidden**: Insufficient permissions\n- **404 Not Found**: Resource not found\n- **405 Method Not Allowed**: Invalid HTTP method\n- **422 Validation Error**: Invalid input data with detailed errors\n- **500 Internal Server Error**: Server error with details (debug mode) or generic message (production)\n\nAll errors follow this format:\n```json\n{\n \"message\": \"Error description\",\n \"error\": \"Additional error details\"\n}\n```\n\n## Base URL:\nUpdate {{base_url}} variable for your environment", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "version": "2.1.0" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{auth_token}}", "type": "string" } ] }, "variable": [ { "key": "base_url", "value": "http://localhost:8000/api", "type": "string" }, { "key": "auth_token", "value": "", "type": "string" }, { "key": "refresh_token", "value": "", "type": "string", "description": "Sanctum refresh token; use with POST /auth/refresh only" }, { "key": "merchant_id", "value": "", "type": "string" }, { "key": "user_id", "value": "", "type": "string" } ], "item": [ { "name": "🔐 Authentication", "description": "User authentication endpoints including registration, login, OTP, and logout", "item": [ { "name": "Register User", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Ahmed Ali\",\n \"email\": \"ahmed@example.com\",\n \"phone\": \"+201234567890\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\",\n \"language\": \"ar\",\n \"city\": \"القاهرة\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/auth/register", "host": ["{{base_url}}"], "path": ["auth", "register"] }, "description": "Register a new user account. Returns user data and authentication token." }, "response": [] }, { "name": "Register Merchant", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Merchant Name\",\n \"email\": \"merchant@example.com\",\n \"phone\": \"+201234567890\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\",\n \"company_name\": \"My Company\",\n \"company_name_ar\": \"شركتي\",\n \"company_name_en\": \"My Company\",\n \"commercial_registration\": \"CR123456\",\n \"tax_number\": \"TAX123456\",\n \"language\": \"ar\",\n \"city\": \"القاهرة\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/auth/register-merchant", "host": ["{{base_url}}"], "path": ["auth", "register-merchant"] }, "description": "Register a new merchant account. Requires admin approval before activation." }, "response": [] }, { "name": "Login", "event": [ { "listen": "test", "script": { "exec": [ "if (pm.response.code === 200) {", " var jsonData = pm.response.json();", " pm.collectionVariables.set(\"auth_token\", jsonData.token);", " if (jsonData.refresh_token) {", " pm.collectionVariables.set(\"refresh_token\", jsonData.refresh_token);", " }", " if (jsonData.user) {", " pm.collectionVariables.set(\"user_id\", jsonData.user.id);", " }", " console.log(\"Token saved: \" + jsonData.token);", "}" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"ahmed@example.com\",\n \"password\": \"password123\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/auth/login", "host": ["{{base_url}}"], "path": ["auth", "login"] }, "description": "Login with email and password. Token is automatically saved to collection variables.\n\n**Note:** All API endpoints now return JSON responses for errors. No HTML responses will be returned." }, "response": [] }, { "name": "Refresh token", "event": [ { "listen": "test", "script": { "exec": [ "if (pm.response.code === 200) {", " var j = pm.response.json();", " if (j.token) pm.collectionVariables.set('auth_token', j.token);", " if (j.refresh_token) pm.collectionVariables.set('refresh_token', j.refresh_token);", "}" ], "type": "text/javascript" } } ], "request": { "auth": { "type": "noauth" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"{{refresh_token}}\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/auth/refresh", "host": ["{{base_url}}"], "path": ["auth", "refresh"] }, "description": "Exchange **refresh_token** for new **token** (access) + new **refresh_token**. Old refresh is revoked.\n\nAliases: `POST {{base_url}}/auth/token/refresh` (same body). Full URL with /api prefix: `/api/auth/refresh`.\n\nOptional: send refresh as `Authorization: Bearer {{refresh_token}}` with empty body." }, "response": [] }, { "name": "Request OTP", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"ahmed@example.com\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/auth/otp/request", "host": ["{{base_url}}"], "path": ["auth", "otp", "request"] }, "description": "Send **either** `email` or `phone` (not both). User must exist. Queues delivery (SMS/WhatsApp/log per `OTP_PHONE_DRIVER`, or email). Repeat within cooldown returns **429**." }, "response": [ { "name": "200 OTP sent", "originalRequest": { "method": "POST", "header": [{"key": "Content-Type", "value": "application/json"}], "body": { "mode": "raw", "raw": "{\n \"email\": \"ahmed@example.com\"\n}" }, "url": { "raw": "{{base_url}}/auth/otp/request", "host": ["{{base_url}}"], "path": ["auth", "otp", "request"] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [{"key": "Content-Type", "value": "application/json"}], "body": "{\n \"success\": true,\n \"message\": \"OTP sent successfully\",\n \"message_ar\": \"تم إرسال رمز التحقق\",\n \"message_en\": \"OTP sent successfully\",\n \"otp\": null\n}" } ] }, { "name": "Verify OTP", "event": [ { "listen": "test", "script": { "exec": [ "if (pm.response.code === 200) {", " var jsonData = pm.response.json();", " if (jsonData.token) {", " pm.collectionVariables.set(\"auth_token\", jsonData.token);", " }", "}" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"ahmed@example.com\",\n \"otp\": \"123456\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/auth/otp/verify", "host": ["{{base_url}}"], "path": ["auth", "otp", "verify"] }, "description": "Verify OTP. Body: `otp` (required) plus `phone` or `email` to identify user, **or** send `Authorization: Bearer` for an existing session user. Returns `token` and `user` (resource shape)." }, "response": [ { "name": "200 Verified", "originalRequest": { "method": "POST", "header": [{"key": "Content-Type", "value": "application/json"}], "body": { "mode": "raw", "raw": "{\n \"email\": \"ahmed@example.com\",\n \"otp\": \"123456\"\n}" }, "url": { "raw": "{{base_url}}/auth/otp/verify", "host": ["{{base_url}}"], "path": ["auth", "otp", "verify"] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [{"key": "Content-Type", "value": "application/json"}], "body": "{\n \"message\": \"OTP verified successfully\",\n \"token\": \"1|examplePlainTextToken\",\n \"user\": {\n \"id\": 1,\n \"name\": \"Ahmed\",\n \"email\": \"ahmed@example.com\",\n \"phone\": \"+201234567890\",\n \"role\": { \"id\": 2, \"name\": \"customer\" }\n }\n}" } ] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/auth/logout", "host": ["{{base_url}}"], "path": ["auth", "logout"] }, "description": "Logout and revoke current authentication token." }, "response": [] } ] }, { "name": "📦 Offers & Categories", "description": "Browse offers and categories", "item": [ { "name": "List Categories", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/categories", "host": ["{{base_url}}"], "path": ["categories"] }, "description": "Get all categories with hierarchical structure." }, "response": [] }, { "name": "Get Category Details", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/categories/1", "host": ["{{base_url}}"], "path": ["categories", "1"] }, "description": "Get detailed information about a specific category." }, "response": [] }, { "name": "List Offers", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/offers?category=1&search=discount&nearby=true&lat=29.3759&lng=47.9774&distance=5000&page=1&per_page=15", "host": ["{{base_url}}"], "path": ["offers"], "query": [ { "key": "category", "value": "1", "description": "Filter by category ID" }, { "key": "search", "value": "discount", "description": "Search in title and description" }, { "key": "nearby", "value": "true", "description": "Enable nearby search" }, { "key": "lat", "value": "29.3759", "description": "Latitude for nearby search" }, { "key": "lng", "value": "47.9774", "description": "Longitude for nearby search" }, { "key": "distance", "value": "5000", "description": "Distance in meters" }, { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "List all active offers with advanced filtering options including category, search, and nearby location." }, "response": [] }, { "name": "Get Offer Details", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/offers/1", "host": ["{{base_url}}"], "path": ["offers", "1"] }, "description": "Get detailed information about a specific offer including merchant and location details." }, "response": [] } ] }, { "name": "🛒 Cart & Orders", "description": "Shopping cart and order management", "item": [ { "name": "Get Cart", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/cart", "host": ["{{base_url}}"], "path": ["cart"] }, "description": "Get current user's shopping cart with all items." }, "response": [] }, { "name": "Add to Cart", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"offer_id\": 1,\n \"quantity\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/cart/add", "host": ["{{base_url}}"], "path": ["cart", "add"] }, "description": "Add offer line (`offer_id` + `quantity`) or single `coupon_id`. Returns `success` and `data` with `cart_id`, `offer_id`, `quantity_added`, `line_total_quantity`. **400** if offer not started, expired, or unavailable." }, "response": [ { "name": "200 Added", "originalRequest": { "method": "POST", "header": [ {"key": "Authorization", "value": "Bearer {{auth_token}}"}, {"key": "Content-Type", "value": "application/json"} ], "body": { "mode": "raw", "raw": "{\n \"offer_id\": 1,\n \"quantity\": 2\n}" }, "url": { "raw": "{{base_url}}/cart/add", "host": ["{{base_url}}"], "path": ["cart", "add"] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [{"key": "Content-Type", "value": "application/json"}], "body": "{\n \"success\": true,\n \"message\": \"Item added to cart successfully\",\n \"message_ar\": \"تمت إضافة العنصر إلى السلة\",\n \"message_en\": \"Item added to cart successfully\",\n \"data\": {\n \"cart_id\": 3,\n \"offer_id\": 1,\n \"quantity_added\": 2,\n \"line_total_quantity\": 2\n }\n}" }, { "name": "400 Offer expired", "originalRequest": { "method": "POST", "header": [ {"key": "Authorization", "value": "Bearer {{auth_token}}"}, {"key": "Content-Type", "value": "application/json"} ], "body": { "mode": "raw", "raw": "{\n \"offer_id\": 99,\n \"quantity\": 1\n}" }, "url": { "raw": "{{base_url}}/cart/add", "host": ["{{base_url}}"], "path": ["cart", "add"] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [{"key": "Content-Type", "value": "application/json"}], "body": "{\n \"success\": false,\n \"message\": \"Offer has expired.\",\n \"message_ar\": \"انتهت صلاحية العرض.\",\n \"message_en\": \"This offer has expired.\"\n}" } ] }, { "name": "Update Cart Item", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"quantity\": 3\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/cart/1", "host": ["{{base_url}}"], "path": ["cart", "1"] }, "description": "Update quantity of a cart item." }, "response": [] }, { "name": "Remove from Cart", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/cart/1", "host": ["{{base_url}}"], "path": ["cart", "1"] }, "description": "Remove an item from the cart." }, "response": [] }, { "name": "Clear Cart", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/cart", "host": ["{{base_url}}"], "path": ["cart"] }, "description": "Clear all items from the cart." }, "response": [] }, { "name": "Checkout", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"payment_method\": \"cash\",\n \"cart_id\": 1\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/orders/checkout", "host": ["{{base_url}}"], "path": ["orders", "checkout"] }, "description": "Create an order from cart items. Generates coupons and processes payment." }, "response": [] }, { "name": "List Orders", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/orders?page=1&per_page=15", "host": ["{{base_url}}"], "path": ["orders"], "query": [ { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get list of user's orders with pagination." }, "response": [] }, { "name": "Get Order Details", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/orders/1", "host": ["{{base_url}}"], "path": ["orders", "1"] }, "description": "Get detailed information about a specific order." }, "response": [] }, { "name": "Get Order Coupons", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/orders/1/coupons", "host": ["{{base_url}}"], "path": ["orders", "1", "coupons"] }, "description": "Get all coupons for a specific order." }, "response": [] }, { "name": "Cancel Order", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/orders/1/cancel", "host": ["{{base_url}}"], "path": ["orders", "1", "cancel"] }, "description": "Cancel an order and restore coupons." }, "response": [] }, { "name": "Get Wallet Coupons", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/wallet/coupons?status=active&page=1", "host": ["{{base_url}}"], "path": ["wallet", "coupons"], "query": [ { "key": "status", "value": "active", "description": "Filter by status: active, used, expired" }, { "key": "page", "value": "1" } ] }, "description": "Get all coupons in user's wallet." }, "response": [] }, { "name": "Create Review", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"order_id\": 1,\n \"merchant_id\": 1,\n \"rating\": 5,\n \"comment\": \"Great service!\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/reviews", "host": ["{{base_url}}"], "path": ["reviews"] }, "description": "Create a review for an order and merchant." }, "response": [] } ] }, { "name": "🏪 Merchant", "description": "Merchant-specific endpoints for managing offers, orders, and locations", "item": [ { "name": "List Merchant Offers", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/offers?status=active&page=1", "host": ["{{base_url}}"], "path": ["merchant", "offers"], "query": [ { "key": "status", "value": "active", "description": "Filter by status: draft, pending, active, expired" }, { "key": "page", "value": "1" } ] }, "description": "Get all offers created by the authenticated merchant." }, "response": [] }, { "name": "Create Offer", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"title_ar\": \"خصم 50% على جميع المنتجات\",\n \"title_en\": \"50% Discount on All Products\",\n \"description_ar\": \"وصف تفصيلي للعرض\",\n \"description_en\": \"Detailed offer description\",\n \"price\": 25.00,\n \"original_price\": 50.00,\n \"discount_percent\": 50,\n \"total_coupons\": 100,\n \"start_at\": \"2024-01-01 00:00:00\",\n \"end_at\": \"2024-12-31 23:59:59\",\n \"category_id\": 1,\n \"location_id\": 1,\n \"images\": [\"https://example.com/image1.jpg\", \"https://example.com/image2.jpg\"]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/merchant/offers", "host": ["{{base_url}}"], "path": ["merchant", "offers"] }, "description": "Create a new offer. Status will be set to 'pending' for admin approval." }, "response": [] }, { "name": "Update Offer", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"title_ar\": \"خصم محدث\",\n \"price\": 20.00,\n \"total_coupons\": 150\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/merchant/offers/1", "host": ["{{base_url}}"], "path": ["merchant", "offers", "1"] }, "description": "Update an existing offer. Only merchant's own offers can be updated." }, "response": [] }, { "name": "Delete Offer", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/offers/1", "host": ["{{base_url}}"], "path": ["merchant", "offers", "1"] }, "description": "Delete an offer. Only draft or pending offers can be deleted." }, "response": [] }, { "name": "List Merchant Orders", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/orders?status=paid&page=1", "host": ["{{base_url}}"], "path": ["merchant", "orders"], "query": [ { "key": "status", "value": "paid", "description": "Filter by payment status" }, { "key": "page", "value": "1" } ] }, "description": "Get all orders for the authenticated merchant." }, "response": [] }, { "name": "Activate Coupon", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/coupons/1/activate", "host": ["{{base_url}}"], "path": ["merchant", "coupons", "1", "activate"] }, "description": "Activate a coupon when customer uses it. Only paid coupons can be activated." }, "response": [] }, { "name": "Get Store Locations", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/locations", "host": ["{{base_url}}"], "path": ["merchant", "locations"] }, "description": "Get all store locations for the authenticated merchant." }, "response": [] }, { "name": "Add Store Location", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name_ar\": \"فرع وسط البلد\",\n \"name_en\": \"Downtown Branch\",\n \"address_ar\": \"وسط البلد، شارع طلعت حرب\",\n \"address_en\": \"Downtown, Talaat Harb Street\",\n \"latitude\": 30.0444,\n \"longitude\": 31.2357,\n \"phone\": \"+201234567890\",\n \"is_active\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/merchant/locations", "host": ["{{base_url}}"], "path": ["merchant", "locations"] }, "description": "Add a new store location for the merchant." }, "response": [] }, { "name": "Get Statistics", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/statistics", "host": ["{{base_url}}"], "path": ["merchant", "statistics"] }, "description": "Get merchant statistics including total orders, revenue, and active offers." }, "response": [] } ] }, { "name": "💰 Financial System", "description": "Complete financial management system for merchants including wallet, transactions, expenses, and withdrawals", "item": [ { "name": "Get Wallet", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/financial/wallet", "host": ["{{base_url}}"], "path": ["merchant", "financial", "wallet"] }, "description": "Get merchant wallet balance and statistics including total earned, withdrawn, and commission paid." }, "response": [] }, { "name": "Get Transactions", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/financial/transactions?type=order_revenue&flow=incoming&from=2024-01-01&to=2024-12-31&page=1", "host": ["{{base_url}}"], "path": ["merchant", "financial", "transactions"], "query": [ { "key": "type", "value": "order_revenue", "description": "Transaction type: order_revenue, commission, withdrawal, refund, expense, subscription" }, { "key": "flow", "value": "incoming", "description": "Transaction flow: incoming, outgoing" }, { "key": "from", "value": "2024-01-01", "description": "Start date (YYYY-MM-DD)" }, { "key": "to", "value": "2024-12-31", "description": "End date (YYYY-MM-DD)" }, { "key": "page", "value": "1" } ] }, "description": "Get complete transaction history with filters." }, "response": [] }, { "name": "Get Earnings Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/financial/earnings?period=month&from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["merchant", "financial", "earnings"], "query": [ { "key": "period", "value": "month", "description": "Period: day, week, month, year" }, { "key": "from", "value": "2024-01-01", "description": "Start date (YYYY-MM-DD)" }, { "key": "to", "value": "2024-12-31", "description": "End date (YYYY-MM-DD)" } ] }, "description": "Get comprehensive earnings report including revenue, expenses, commission, withdrawals, and profit & loss." }, "response": [] }, { "name": "Record Expense", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"expense_type\": \"advertising\",\n \"expense_type_ar\": \"إعلانات\",\n \"expense_type_en\": \"Advertising\",\n \"category\": \"online_ads\",\n \"category_ar\": \"إعلانات إلكترونية\",\n \"category_en\": \"Online Ads\",\n \"amount\": 500.00,\n \"description\": \"Facebook ads campaign\",\n \"description_ar\": \"حملة إعلانات فيسبوك\",\n \"description_en\": \"Facebook ads campaign\",\n \"expense_date\": \"2024-01-15\",\n \"receipt_url\": \"https://example.com/receipt.pdf\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/merchant/financial/expenses", "host": ["{{base_url}}"], "path": ["merchant", "financial", "expenses"] }, "description": "Record a new expense. Expense types: advertising, subscription, fees, other" }, "response": [] }, { "name": "Get Expenses", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/financial/expenses?type=advertising&from=2024-01-01&to=2024-12-31&page=1", "host": ["{{base_url}}"], "path": ["merchant", "financial", "expenses"], "query": [ { "key": "type", "value": "advertising", "description": "Expense type filter" }, { "key": "from", "value": "2024-01-01", "description": "Start date (YYYY-MM-DD)" }, { "key": "to", "value": "2024-12-31", "description": "End date (YYYY-MM-DD)" }, { "key": "page", "value": "1" } ] }, "description": "Get list of all expenses with filters." }, "response": [] }, { "name": "Request Withdrawal", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"amount\": 1000.00,\n \"withdrawal_method\": \"bank_transfer\",\n \"account_details\": \"Bank: ABC Bank, Account: 1234567890, IBAN: EG123456789\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/merchant/financial/withdrawals", "host": ["{{base_url}}"], "path": ["merchant", "financial", "withdrawals"] }, "description": "Request a withdrawal. Amount will be moved to pending balance until admin approval." }, "response": [] }, { "name": "Get Withdrawals", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/financial/withdrawals?status=pending&page=1", "host": ["{{base_url}}"], "path": ["merchant", "financial", "withdrawals"], "query": [ { "key": "status", "value": "pending", "description": "Filter by status: pending, approved, rejected, completed" }, { "key": "page", "value": "1" } ] }, "description": "Get list of all withdrawal requests with status tracking." }, "response": [] }, { "name": "Get Sales Tracking", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/merchant/financial/sales?from=2024-01-01&to=2024-12-31&page=1", "host": ["{{base_url}}"], "path": ["merchant", "financial", "sales"], "query": [ { "key": "from", "value": "2024-01-01", "description": "Start date (YYYY-MM-DD)" }, { "key": "to", "value": "2024-12-31", "description": "End date (YYYY-MM-DD)" }, { "key": "page", "value": "1" } ] }, "description": "Get detailed sales tracking including customer info, order details, and payment methods." }, "response": [] } ] }, { "name": "👑 Admin", "description": "Admin control panel endpoints for managing users, merchants, offers, reports, and platform settings", "item": [ { "name": "Users Management", "item": [ { "name": "List Users", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/users?role=user&page=1&per_page=15", "host": ["{{base_url}}"], "path": ["admin", "users"], "query": [ { "key": "role", "value": "user", "description": "Filter by role" }, { "key": "page", "value": "1" }, { "key": "per_page", "value": "15" } ] }, "description": "Get list of all users with filters." }, "response": [] }, { "name": "Get User Details", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/users/1", "host": ["{{base_url}}"], "path": ["admin", "users", "1"] }, "description": "Get detailed information about a specific user." }, "response": [] }, { "name": "Update User", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Name\",\n \"email\": \"updated@example.com\",\n \"role_id\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/users/1", "host": ["{{base_url}}"], "path": ["admin", "users", "1"] }, "description": "Update user information including role assignment." }, "response": [] }, { "name": "Create User", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"New User\",\n \"email\": \"newuser@example.com\",\n \"phone\": \"+201234567890\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\",\n \"role_id\": 3,\n \"language\": \"ar\",\n \"city\": \"القاهرة\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/users", "host": ["{{base_url}}"], "path": ["admin", "users"] }, "description": "Create a new user account. Admin can create users with any role." }, "response": [] }, { "name": "Block/Unblock User", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"is_blocked\": true,\n \"reason\": \"Violation of terms\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/users/1/block", "host": ["{{base_url}}"], "path": ["admin", "users", "1", "block"] }, "description": "Block or unblock a user account." }, "response": [] }, { "name": "Delete User", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/users/1", "host": ["{{base_url}}"], "path": ["admin", "users", "1"] }, "description": "Delete user with GDPR compliance (data anonymization)." }, "response": [] } ] }, { "name": "Merchants Management", "item": [ { "name": "List Merchants", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/merchants?approved=true&page=1", "host": ["{{base_url}}"], "path": ["admin", "merchants"], "query": [ { "key": "approved", "value": "true", "description": "Filter by approval status" }, { "key": "page", "value": "1" } ] }, "description": "Get list of all merchants with approval status." }, "response": [] }, { "name": "Get Merchant Details", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/merchants/1", "host": ["{{base_url}}"], "path": ["admin", "merchants", "1"] }, "description": "Get detailed information about a specific merchant including created coupons count." }, "response": [] }, { "name": "Create Merchant", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"New Merchant\",\n \"email\": \"merchant@example.com\",\n \"phone\": \"+201234567890\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\",\n \"company_name\": \"Company Name\",\n \"company_name_ar\": \"اسم الشركة\",\n \"company_name_en\": \"Company Name\",\n \"commercial_registration\": \"CR123456\",\n \"tax_number\": \"TAX123456\",\n \"language\": \"ar\",\n \"city\": \"القاهرة\",\n \"is_approved\": false\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/merchants", "host": ["{{base_url}}"], "path": ["admin", "merchants"] }, "description": "Create a new merchant account. City is required and must be one of Egypt governorates. Country is automatically set to Egypt." }, "response": [] }, { "name": "Update Merchant", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Updated Merchant Name\",\n \"company_name\": \"Updated Company\",\n \"city\": \"حولي\",\n \"is_approved\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/merchants/1", "host": ["{{base_url}}"], "path": ["admin", "merchants", "1"] }, "description": "Update merchant information. Country is automatically set to Egypt." }, "response": [] }, { "name": "Delete Merchant", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/merchants/1", "host": ["{{base_url}}"], "path": ["admin", "merchants", "1"] }, "description": "Delete a merchant. Cannot delete if merchant has orders." }, "response": [] }, { "name": "Approve Merchant", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/merchants/1/approve", "host": ["{{base_url}}"], "path": [ "admin", "merchants", "1", "approve" ] }, "description": "Approve a merchant account. Merchant can then create offers." }, "response": [] }, { "name": "Block/Unblock Merchant", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"is_blocked\": true,\n \"reason\": \"Violation of terms\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/merchants/1/block", "host": ["{{base_url}}"], "path": ["admin", "merchants", "1", "block"] }, "description": "Block or unblock a merchant. Also blocks the associated user account." }, "response": [] }, { "name": "Update Merchant Commission", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"commission_mode\": \"custom\",\n \"commission_custom_percent\": 8.5\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/merchants/1/commission", "host": ["{{base_url}}"], "path": ["admin", "merchants", "1", "commission"] }, "description": "`commission_mode`: `platform` (default rate), `custom` (requires `commission_custom_percent` 0–100), or `waived` (0% effective)." }, "response": [ { "name": "200 Updated", "originalRequest": { "method": "PUT", "header": [ {"key": "Authorization", "value": "Bearer {{auth_token}}"}, {"key": "Content-Type", "value": "application/json"} ], "body": { "mode": "raw", "raw": "{\n \"commission_mode\": \"custom\",\n \"commission_custom_percent\": 8.5\n}" }, "url": { "raw": "{{base_url}}/admin/merchants/1/commission", "host": ["{{base_url}}"], "path": ["admin", "merchants", "1", "commission"] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [{"key": "Content-Type", "value": "application/json"}], "body": "{\n \"success\": true,\n \"message\": \"Commission settings updated successfully.\",\n \"message_ar\": \"تم تحديث إعدادات العمولة.\",\n \"data\": {\n \"commission_mode\": \"custom\",\n \"commission_custom_percent\": 8.5,\n \"effective_commission_percent\": 8.5,\n \"platform_default_commission_percent\": 10\n }\n}" } ] } ] }, { "name": "Offers Management", "item": [ { "name": "List All Offers", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/offers?status=pending&page=1", "host": ["{{base_url}}"], "path": ["admin", "offers"], "query": [ { "key": "status", "value": "pending", "description": "Filter by status" }, { "key": "page", "value": "1" } ] }, "description": "Get all offers across all merchants for admin review." }, "response": [] }, { "name": "Get Offer Details", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/offers/1", "host": ["{{base_url}}"], "path": ["admin", "offers", "1"] }, "description": "Get detailed information about a specific offer." }, "response": [] }, { "name": "Create Offer", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"merchant_id\": 1,\n \"category_id\": 1,\n \"coupon_id\": 1,\n \"title_ar\": \"عرض الصيف الكبير\",\n \"title_en\": \"Big Summer Offer\",\n \"description_ar\": \"وصف العرض\",\n \"description_en\": \"Offer description\",\n \"price\": 25.00,\n \"original_price\": 50.00,\n \"discount_percent\": 50,\n \"total_coupons\": 100,\n \"start_at\": \"2024-01-01 00:00:00\",\n \"end_at\": \"2024-12-31 23:59:59\",\n \"status\": \"active\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/offers", "host": ["{{base_url}}"], "path": ["admin", "offers"] }, "description": "Create a new offer. Requires coupon_id that belongs to the same category." }, "response": [] }, { "name": "Update Offer", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"title_ar\": \"عرض محدث\",\n \"price\": 30.00,\n \"status\": \"active\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/offers/1", "host": ["{{base_url}}"], "path": ["admin", "offers", "1"] }, "description": "Update offer details." }, "response": [] }, { "name": "Delete Offer", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/offers/1", "host": ["{{base_url}}"], "path": ["admin", "offers", "1"] }, "description": "Delete an offer. Cannot delete if offer has orders." }, "response": [] }, { "name": "Approve Offer", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"active\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/offers/1/approve", "host": ["{{base_url}}"], "path": ["admin", "offers", "1", "approve"] }, "description": "Approve or reject an offer. Status: active or rejected. Requires coupon before approval." }, "response": [] } ] }, { "name": "Reports", "item": [ { "name": "Users Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/users?role=user&from=2024-01-01&to=2024-12-31&search=ahmed", "host": ["{{base_url}}"], "path": ["admin", "reports", "users"], "query": [ { "key": "role", "value": "user" }, { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" }, { "key": "search", "value": "ahmed" } ] }, "description": "Generate users report with advanced filtering." }, "response": [] }, { "name": "Merchants Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/merchants?approved=true&from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["admin", "reports", "merchants"], "query": [ { "key": "approved", "value": "true" }, { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Generate merchants report with filters." }, "response": [] }, { "name": "Orders Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/orders?merchant=1&payment_status=paid&from=2024-01-01&to=2024-12-31&min_amount=10&max_amount=1000", "host": ["{{base_url}}"], "path": ["admin", "reports", "orders"], "query": [ { "key": "merchant", "value": "1" }, { "key": "payment_status", "value": "paid" }, { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" }, { "key": "min_amount", "value": "10" }, { "key": "max_amount", "value": "1000" } ] }, "description": "Generate orders report with comprehensive filters." }, "response": [] }, { "name": "Products Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/products?merchant=1&category=1&status=active&from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["admin", "reports", "products"], "query": [ { "key": "merchant", "value": "1" }, { "key": "category", "value": "1" }, { "key": "status", "value": "active" }, { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Generate products/offers report." }, "response": [] }, { "name": "Payments Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/payments?status=success&gateway=stripe&from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["admin", "reports", "payments"], "query": [ { "key": "status", "value": "success" }, { "key": "gateway", "value": "stripe" }, { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Generate payments report." }, "response": [] }, { "name": "Financial Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/financial?merchant=1&type=order_revenue&flow=incoming&from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["admin", "reports", "financial"], "query": [ { "key": "merchant", "value": "1" }, { "key": "type", "value": "order_revenue" }, { "key": "flow", "value": "incoming" }, { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Generate financial transactions report." }, "response": [] }, { "name": "Sales Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/sales?from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["admin", "reports", "sales"], "query": [ { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Generate sales report grouped by merchant." }, "response": [] }, { "name": "Export Report PDF", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/export/users/pdf?from=2024-01-01&to=2024-12-31&language=ar", "host": ["{{base_url}}"], "path": [ "admin", "reports", "export", "users", "pdf" ], "query": [ { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" }, { "key": "language", "value": "ar", "description": "Language: ar or en" } ] }, "description": "Export report as PDF. Type: users, merchants, orders, products, payments, financial" }, "response": [] }, { "name": "Export Report Excel", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports/export/orders/excel?from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": [ "admin", "reports", "export", "orders", "excel" ], "query": [ { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Export report as Excel. Type: users, merchants, orders, products, payments, financial" }, "response": [] } ] }, { "name": "Financial Dashboard", "item": [ { "name": "Get Financial Dashboard", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/financial/dashboard?from=2024-01-01&to=2024-12-31", "host": ["{{base_url}}"], "path": ["admin", "financial", "dashboard"], "query": [ { "key": "from", "value": "2024-01-01" }, { "key": "to", "value": "2024-12-31" } ] }, "description": "Get comprehensive financial dashboard with platform revenue, payouts, outstanding balances, and monthly analytics." }, "response": [] } ] }, { "name": "Withdrawals Management", "item": [ { "name": "List Withdrawals", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/withdrawals?status=pending&merchant=1&page=1", "host": ["{{base_url}}"], "path": ["admin", "withdrawals"], "query": [ { "key": "status", "value": "pending", "description": "Filter by status: pending, approved, rejected, completed" }, { "key": "merchant", "value": "1" }, { "key": "page", "value": "1" } ] }, "description": "Get all withdrawal requests with filters." }, "response": [] }, { "name": "Approve Withdrawal", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/withdrawals/1/approve", "host": ["{{base_url}}"], "path": [ "admin", "withdrawals", "1", "approve" ] }, "description": "Approve a withdrawal request. Moves amount from pending to withdrawn." }, "response": [] }, { "name": "Reject Withdrawal", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"Insufficient documentation\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/withdrawals/1/reject", "host": ["{{base_url}}"], "path": [ "admin", "withdrawals", "1", "reject" ] }, "description": "Reject a withdrawal request. Returns balance to merchant wallet." }, "response": [] }, { "name": "Complete Withdrawal", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/withdrawals/1/complete", "host": ["{{base_url}}"], "path": [ "admin", "withdrawals", "1", "complete" ] }, "description": "Mark withdrawal as completed after payment is processed." }, "response": [] } ] }, { "name": "Roles & Permissions", "item": [ { "name": "List Permissions", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/permissions", "host": ["{{base_url}}"], "path": ["admin", "permissions"] }, "description": "Get all permissions grouped by permission groups." }, "response": [] }, { "name": "Create Permission", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"reports.export\",\n \"name_ar\": \"تصدير التقارير\",\n \"name_en\": \"Export Reports\",\n \"group\": \"reports\",\n \"group_ar\": \"التقارير\",\n \"group_en\": \"Reports\",\n \"description\": \"Permission to export reports\",\n \"description_ar\": \"صلاحية تصدير التقارير\",\n \"description_en\": \"Permission to export reports\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/permissions", "host": ["{{base_url}}"], "path": ["admin", "permissions"] }, "description": "Create a new permission." }, "response": [] }, { "name": "List Roles", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/roles", "host": ["{{base_url}}"], "path": ["admin", "roles"] }, "description": "Get all roles with their assigned permissions." }, "response": [] }, { "name": "Create Role", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"moderator\",\n \"name_ar\": \"مشرف\",\n \"name_en\": \"Moderator\",\n \"description\": \"Moderator role with limited permissions\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/roles", "host": ["{{base_url}}"], "path": ["admin", "roles"] }, "description": "Create a new role." }, "response": [] }, { "name": "Assign Permissions to Role", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"permissions\": [1, 2, 3, 4, 5]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/roles/1/permissions", "host": ["{{base_url}}"], "path": [ "admin", "roles", "1", "permissions" ] }, "description": "Assign permissions to a role. Replaces existing permissions." }, "response": [] } ] }, { "name": "Settings", "item": [ { "name": "Get Settings", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/settings", "host": ["{{base_url}}"], "path": ["admin", "settings"] }, "description": "Get all platform settings." }, "response": [] }, { "name": "Update Settings", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"app_name\": \"OFROO\",\n \"app_logo\": \"/images/logo.png\",\n \"commission_rate\": 0.10,\n \"feature_gps\": true,\n \"feature_electronic_payments\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/settings", "host": ["{{base_url}}"], "path": ["admin", "settings"] }, "description": "Update platform settings." }, "response": [] }, { "name": "Update Category Order", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"categories\": [\n {\"id\": 1, \"order_index\": 1},\n {\"id\": 2, \"order_index\": 2},\n {\"id\": 3, \"order_index\": 3}\n ]\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/categories/order", "host": ["{{base_url}}"], "path": ["admin", "categories", "order"] }, "description": "Update category display order." }, "response": [] } ] }, { "name": "Categories Management", "item": [ { "name": "List Categories (Admin)", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/categories", "host": ["{{base_url}}"], "path": ["admin", "categories"] }, "description": "Get all categories for admin management." }, "response": [] }, { "name": "Get Category Details", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/categories/1", "host": ["{{base_url}}"], "path": ["admin", "categories", "1"] }, "description": "Get detailed information about a specific category." }, "response": [] }, { "name": "Create Category", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name_ar\": \"قسم جديد\",\n \"name_en\": \"New Category\",\n \"parent_id\": null,\n \"order_index\": 1\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/categories", "host": ["{{base_url}}"], "path": ["admin", "categories"] }, "description": "Create a new category." }, "response": [] }, { "name": "Update Category", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name_ar\": \"قسم محدث\",\n \"name_en\": \"Updated Category\",\n \"order_index\": 2\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/categories/1", "host": ["{{base_url}}"], "path": ["admin", "categories", "1"] }, "description": "Update category information." }, "response": [] }, { "name": "Delete Category", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/categories/1", "host": ["{{base_url}}"], "path": ["admin", "categories", "1"] }, "description": "Delete a category. Cannot delete if category has subcategories or offers." }, "response": [] } ] }, { "name": "Coupons Management", "item": [ { "name": "List All Coupons", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/coupons/allCoupons?status=active&category_id=1&page=1", "host": ["{{base_url}}"], "path": ["admin", "coupons", "allCoupons"], "query": [ { "key": "status", "value": "active" }, { "key": "category_id", "value": "1" }, { "key": "page", "value": "1" } ] }, "description": "Get all coupons with filters (status, category_id, search)." }, "response": [] }, { "name": "Get Coupon Details", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/coupons/1", "host": ["{{base_url}}"], "path": ["admin", "coupons", "1"] }, "description": "Get detailed information about a specific coupon." }, "response": [] }, { "name": "Create Coupon", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"category_id\": 1,\n \"usage_limit\": 100,\n \"discount_percent\": 25,\n \"status\": \"active\",\n \"expires_at\": \"2024-12-31 23:59:59\",\n \"terms_conditions\": \"Terms and conditions\",\n \"is_refundable\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/coupons", "host": ["{{base_url}}"], "path": ["admin", "coupons"] }, "description": "Create a new coupon. Requires category_id and usage_limit." }, "response": [] }, { "name": "Update Coupon", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"active\",\n \"usage_limit\": 150,\n \"expires_at\": \"2024-12-31 23:59:59\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/coupons/1", "host": ["{{base_url}}"], "path": ["admin", "coupons", "1"] }, "description": "Update coupon details." }, "response": [] }, { "name": "Delete Coupon", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/coupons/1", "host": ["{{base_url}}"], "path": ["admin", "coupons", "1"] }, "description": "Delete a coupon. Cannot delete activated or used coupons." }, "response": [] }, { "name": "Activate Coupon", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/coupons/1/activate", "host": ["{{base_url}}"], "path": [ "admin", "coupons", "1", "activate" ] }, "description": "Activate a coupon." }, "response": [] }, { "name": "Deactivate Coupon", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/coupons/1/deactivate", "host": ["{{base_url}}"], "path": [ "admin", "coupons", "1", "deactivate" ] }, "description": "Deactivate a coupon." }, "response": [] } ] }, { "name": "Warnings Management", "item": [ { "name": "List Merchant Warnings", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/warnings/merchants?merchant_id=1&active=true&page=1", "host": ["{{base_url}}"], "path": ["admin", "warnings", "merchants"], "query": [ { "key": "merchant_id", "value": "1" }, { "key": "active", "value": "true" }, { "key": "page", "value": "1" } ] }, "description": "Get all merchant warnings with filters." }, "response": [] }, { "name": "List User Warnings", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/warnings/users?user_id=1&page=1", "host": ["{{base_url}}"], "path": ["admin", "warnings", "users"], "query": [ { "key": "user_id", "value": "1" }, { "key": "page", "value": "1" } ] }, "description": "Get all user warnings with filters." }, "response": [] }, { "name": "Issue Warning to Merchant", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"warning_type\": \"violation\",\n \"message\": \"Warning message to merchant\",\n \"expires_at\": \"2024-12-31 23:59:59\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/warnings/merchants/1", "host": ["{{base_url}}"], "path": [ "admin", "warnings", "merchants", "1" ] }, "description": "Issue a warning to a merchant." }, "response": [] }, { "name": "Issue Warning to User", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"warning_type\": \"violation\",\n \"message\": \"Warning message to user\",\n \"expires_at\": \"2024-12-31 23:59:59\",\n \"severity\": \"medium\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/warnings/users/1", "host": ["{{base_url}}"], "path": ["admin", "warnings", "users", "1"] }, "description": "Issue a warning to a user." }, "response": [] }, { "name": "Deactivate Warning", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/warnings/1/deactivate", "host": ["{{base_url}}"], "path": [ "admin", "warnings", "1", "deactivate" ] }, "description": "Deactivate a merchant warning." }, "response": [] }, { "name": "Deactivate User Warning", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/warnings/users/1/deactivate", "host": ["{{base_url}}"], "path": [ "admin", "warnings", "users", "1", "deactivate" ] }, "description": "Deactivate a user warning." }, "response": [] } ] }, { "name": "Courses", "item": [ { "name": "List Courses", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/courses?merchant=1&status=active&page=1", "host": ["{{base_url}}"], "path": ["admin", "courses"], "query": [ { "key": "merchant", "value": "1" }, { "key": "status", "value": "active" }, { "key": "page", "value": "1" } ] }, "description": "Get all courses with filters." }, "response": [] }, { "name": "Create Course", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"title_ar\": \"دورة تعليمية\",\n \"title_en\": \"Educational Course\",\n \"description_ar\": \"وصف الدورة\",\n \"description_en\": \"Course description\",\n \"price\": 100.00,\n \"duration_hours\": 40,\n \"merchant_id\": 1,\n \"certificate_eligible\": true,\n \"start_date\": \"2024-02-01\",\n \"end_date\": \"2024-03-01\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/courses", "host": ["{{base_url}}"], "path": ["admin", "courses"] }, "description": "Create a new course." }, "response": [] } ] }, { "name": "Certificates", "item": [ { "name": "List Certificates", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/certificates?type=course_completion&page=1", "host": ["{{base_url}}"], "path": ["admin", "certificates"], "query": [ { "key": "type", "value": "course_completion", "description": "Filter by type: course_completion, quran_memorization" }, { "key": "page", "value": "1" } ] }, "description": "Get all certificates with filters." }, "response": [] }, { "name": "Generate Certificate", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"course_completion\",\n \"user_id\": 1,\n \"course_id\": 1\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/certificates/generate", "host": ["{{base_url}}"], "path": [ "admin", "certificates", "generate" ] }, "description": "Generate a certificate. Types: course_completion (requires course_id), quran_memorization (requires riwayah)" }, "response": [] }, { "name": "Verify Certificate", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/certificates/verify/CERT-ABC123XYZ", "host": ["{{base_url}}"], "path": [ "certificates", "verify", "CERT-ABC123XYZ" ] }, "description": "Verify a certificate by certificate number. Public endpoint." }, "response": [] } ] }, { "name": "Regulatory Checks", "item": [ { "name": "List Regulatory Checks", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/regulatory-checks?merchant_id=&check_type=&result=&from=&to=&page=1", "host": ["{{base_url}}"], "path": ["admin", "regulatory-checks"], "query": [ { "key": "merchant_id", "value": "", "description": "Filter by merchant ID" }, { "key": "check_type", "value": "", "description": "Filter by type: compliance, kyc, financial, operational, legal" }, { "key": "result", "value": "", "description": "Filter by result: passed, failed, pending, requires_review" }, { "key": "from", "value": "", "description": "Start date (YYYY-MM-DD)" }, { "key": "to", "value": "", "description": "End date (YYYY-MM-DD)" }, { "key": "page", "value": "1" } ] }, "description": "List all regulatory checks with filters." }, "response": [] }, { "name": "Create Regulatory Check", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"merchant_id\": 1,\n \"check_type\": \"compliance\",\n \"result\": \"passed\",\n \"details\": {},\n \"notes\": \"All checks passed\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/regulatory-checks", "host": ["{{base_url}}"], "path": ["admin", "regulatory-checks"] }, "description": "Create a new regulatory check for a merchant." }, "response": [] }, { "name": "Get Regulatory Check", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/regulatory-checks/1", "host": ["{{base_url}}"], "path": ["admin", "regulatory-checks", "1"] }, "description": "Get specific regulatory check details." }, "response": [] }, { "name": "Update Regulatory Check", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"result\": \"passed\",\n \"notes\": \"Updated notes\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/regulatory-checks/1", "host": ["{{base_url}}"], "path": ["admin", "regulatory-checks", "1"] }, "description": "Update regulatory check." }, "response": [] }, { "name": "Delete Regulatory Check", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/regulatory-checks/1", "host": ["{{base_url}}"], "path": ["admin", "regulatory-checks", "1"] }, "description": "Delete regulatory check." }, "response": [] }, { "name": "Get Merchant Checks", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/regulatory-checks/merchants/1", "host": ["{{base_url}}"], "path": [ "admin", "regulatory-checks", "merchants", "1" ] }, "description": "Get all regulatory checks for a specific merchant." }, "response": [] }, { "name": "Run Automated Check", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"check_type\": \"financial\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/regulatory-checks/merchants/1/automated", "host": ["{{base_url}}"], "path": [ "admin", "regulatory-checks", "merchants", "1", "automated" ] }, "description": "Run automated compliance check for a merchant." }, "response": [] } ] }, { "name": "Financial Reports Cache", "item": [ { "name": "List Cached Reports", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports-cache?name=&file_format=&from=&to=&page=1", "host": ["{{base_url}}"], "path": ["admin", "reports-cache"], "query": [ { "key": "name", "value": "", "description": "Filter by report name" }, { "key": "file_format", "value": "", "description": "Filter by format: pdf, excel, csv" }, { "key": "from", "value": "", "description": "Start date (YYYY-MM-DD)" }, { "key": "to", "value": "", "description": "End date (YYYY-MM-DD)" }, { "key": "page", "value": "1" } ] }, "description": "List all cached financial reports." }, "response": [] }, { "name": "Get Cached Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports-cache/1", "host": ["{{base_url}}"], "path": ["admin", "reports-cache", "1"] }, "description": "Get specific cached report details." }, "response": [] }, { "name": "Generate and Cache Report", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"report_type\": \"financial\",\n \"format\": \"pdf\",\n \"params\": {\n \"from\": \"2024-01-01\",\n \"to\": \"2024-12-31\"\n },\n \"cache_duration\": 24\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/reports-cache/generate", "host": ["{{base_url}}"], "path": [ "admin", "reports-cache", "generate" ] }, "description": "Generate and cache a financial report. Report types: users, merchants, orders, payments, financial, subscriptions, courses, certificates. Formats: pdf, excel, csv." }, "response": [] }, { "name": "Download Cached Report", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports-cache/1/download", "host": ["{{base_url}}"], "path": [ "admin", "reports-cache", "1", "download" ] }, "description": "Download cached report file." }, "response": [] }, { "name": "Delete Cached Report", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports-cache/1", "host": ["{{base_url}}"], "path": ["admin", "reports-cache", "1"] }, "description": "Delete cached report." }, "response": [] }, { "name": "Clear Expired Reports", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports-cache/clear-expired", "host": ["{{base_url}}"], "path": [ "admin", "reports-cache", "clear-expired" ] }, "description": "Clear expired cached reports (older than 30 days)." }, "response": [] }, { "name": "Get Cache Statistics", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reports-cache/statistics", "host": ["{{base_url}}"], "path": [ "admin", "reports-cache", "statistics" ] }, "description": "Get cache statistics (total reports, size, by format, etc)." }, "response": [] } ] }, { "name": "Admin Wallet", "item": [ { "name": "Get Admin Wallet", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/wallet", "host": ["{{base_url}}"], "path": ["admin", "wallet"] }, "description": "Get admin wallet balance and details." }, "response": [] }, { "name": "Get Admin Wallet Transactions", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/wallet/transactions?type=&from=&to=&page=1", "host": ["{{base_url}}"], "path": ["admin", "wallet", "transactions"], "query": [ { "key": "type", "value": "", "description": "Filter by transaction type" }, { "key": "from", "value": "", "description": "Start date" }, { "key": "to", "value": "", "description": "End date" }, { "key": "page", "value": "1" } ] }, "description": "Get admin wallet transactions." }, "response": [] }, { "name": "Adjust Admin Wallet", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"amount\": 1000,\n \"type\": \"credit\",\n \"reason\": \"Manual adjustment\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/wallet/adjust", "host": ["{{base_url}}"], "path": ["admin", "wallet", "adjust"] }, "description": "Manually adjust admin wallet balance." }, "response": [] }, { "name": "Get Merchant Wallet (Admin)", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/wallet/merchants/1", "host": ["{{base_url}}"], "path": [ "admin", "wallet", "merchants", "1" ] }, "description": "Get merchant wallet details (admin view)." }, "response": [] } ] }, { "name": "Merchant Verification", "item": [ { "name": "List Verifications", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/verifications?status=&page=1", "host": ["{{base_url}}"], "path": ["admin", "verifications"], "query": [ { "key": "status", "value": "", "description": "Filter by status: pending, verified, rejected" }, { "key": "page", "value": "1" } ] }, "description": "List all merchant verifications (KYC)." }, "response": [] }, { "name": "Review Verification", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"verified\",\n \"admin_notes\": \"All documents verified\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/verifications/1/review", "host": ["{{base_url}}"], "path": [ "admin", "verifications", "1", "review" ] }, "description": "Review and approve/reject merchant verification (KYC)." }, "response": [] }, { "name": "Download Verification Document", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/verifications/1/documents/commercial_registration", "host": ["{{base_url}}"], "path": [ "admin", "verifications", "1", "documents", "commercial_registration" ] }, "description": "Download verification document. Types: commercial_registration, tax_certificate, id_copy, address_proof, additional_documents." }, "response": [] } ] }, { "name": "Merchant Warnings", "item": [ { "name": "List Warnings", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/warnings?merchant_id=&active=&page=1", "host": ["{{base_url}}"], "path": ["admin", "warnings"], "query": [ { "key": "merchant_id", "value": "", "description": "Filter by merchant ID" }, { "key": "active", "value": "", "description": "Filter by active status: true, false" }, { "key": "page", "value": "1" } ] }, "description": "List all merchant warnings." }, "response": [] }, { "name": "Issue Warning", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"policy_violation\",\n \"severity\": \"high\",\n \"message\": \"Violation of terms and conditions\",\n \"message_ar\": \"انتهاك الشروط والأحكام\",\n \"action_required\": \"Please review your offers\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/warnings/merchants/1", "host": ["{{base_url}}"], "path": [ "admin", "warnings", "merchants", "1" ] }, "description": "Issue a warning to a merchant." }, "response": [] }, { "name": "Deactivate Warning", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/warnings/1/deactivate", "host": ["{{base_url}}"], "path": [ "admin", "warnings", "1", "deactivate" ] }, "description": "Deactivate a warning (mark as resolved)." }, "response": [] } ] }, { "name": "Review Moderation", "item": [ { "name": "List Reviews", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reviews?merchant_id=&moderated=&page=1", "host": ["{{base_url}}"], "path": ["admin", "reviews"], "query": [ { "key": "merchant_id", "value": "", "description": "Filter by merchant ID" }, { "key": "moderated", "value": "", "description": "Filter by moderation status: true, false" }, { "key": "page", "value": "1" } ] }, "description": "List all reviews for moderation." }, "response": [] }, { "name": "Moderate Review", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"action\": \"delete\",\n \"reason\": \"Inappropriate content\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/reviews/1/moderate", "host": ["{{base_url}}"], "path": [ "admin", "reviews", "1", "moderate" ] }, "description": "Moderate a review. Actions: delete, hide. Reason is required." }, "response": [] }, { "name": "Restore Review", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/reviews/1/restore", "host": ["{{base_url}}"], "path": ["admin", "reviews", "1", "restore"] }, "description": "Restore a moderated review." }, "response": [] } ] }, { "name": "Merchant Suspension", "item": [ { "name": "Suspend Merchant", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"reason\": \"Policy violation\",\n \"suspended_until\": \"2024-12-31\",\n \"freeze_wallet\": false,\n \"hide_offers\": true\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/admin/merchants/1/suspend", "host": ["{{base_url}}"], "path": [ "admin", "merchants", "1", "suspend" ] }, "description": "Suspend a merchant account. Can optionally freeze wallet and hide offers." }, "response": [] }, { "name": "Get Merchant Wallet (Admin)", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{auth_token}}" } ], "url": { "raw": "{{base_url}}/admin/merchants/1/wallet", "host": ["{{base_url}}"], "path": [ "admin", "merchants", "1", "wallet" ] }, "description": "Get merchant wallet details (admin view)." }, "response": [] } ] } ] } ] }