{ "openapi": "3.0.0", "info": { "title": "CrossPay Mobile API", "description": "Complete RESTful API for CrossPay mobile application with currency exchange, wallet management, and P2P trading functionality. Supports 4 currencies: AOA, USD, EUR, ZAR.", "version": "1.0.0", "contact": { "name": "CrossPay API Support", "email": "support@crosspay.com" }, "x-registered-route-count": 88 }, "servers": [ { "url": "http://localhost/api/v1", "description": "Current API server" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } }, "schemas": { "User": { "type": "object", "properties": { "id": { "type": "integer" }, "uuid": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "email": { "type": "string", "format": "email" }, "phone": { "type": "string" }, "verification_status": { "type": "string", "enum": [ "unverified", "pending", "verified", "rejected" ] }, "preferred_currency": { "type": "string", "length": 3 }, "marketing_emails": { "type": "boolean" }, "is_active": { "type": "boolean" }, "created_at": { "type": "string", "format": "date-time" } } }, "Wallet": { "type": "object", "properties": { "id": { "type": "integer" }, "type": { "type": "string", "enum": [ "main", "savings" ] }, "currency": { "type": "string", "length": 3 }, "balance": { "type": "number", "format": "float" }, "frozen_balance": { "type": "number", "format": "float" }, "available_balance": { "type": "number", "format": "float" }, "is_active": { "type": "boolean" }, "is_default": { "type": "boolean" } } }, "Transaction": { "type": "object", "properties": { "id": { "type": "integer" }, "uuid": { "type": "string", "format": "uuid" }, "type": { "type": "string", "enum": [ "deposit", "withdrawal", "transfer", "send", "receive", "exchange" ] }, "amount": { "type": "number", "format": "float" }, "net_amount": { "type": "number", "format": "float" }, "currency": { "type": "string", "length": 3 }, "fee": { "type": "number", "format": "float" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed", "cancelled" ] }, "created_at": { "type": "string", "format": "date-time" } } }, "ExchangeRequest": { "type": "object", "properties": { "id": { "type": "integer" }, "uuid": { "type": "string", "format": "uuid" }, "from_currency": { "type": "string", "length": 3 }, "to_currency": { "type": "string", "length": 3 }, "from_amount": { "type": "number", "format": "float" }, "to_amount": { "type": "number", "format": "float" }, "exchange_rate": { "type": "number", "format": "float" }, "fee": { "type": "number", "format": "float" }, "status": { "type": "string", "enum": [ "pending", "approved", "declined", "completed", "cancelled" ] }, "created_at": { "type": "string", "format": "date-time" } } }, "Admin": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "email": { "type": "string", "format": "email" }, "is_active": { "type": "boolean" }, "last_login_at": { "type": "string", "format": "date-time" }, "created_at": { "type": "string", "format": "date-time" } } }, "ErrorResponse": { "type": "object", "properties": { "success": { "type": "boolean", "example": false }, "message": { "type": "string" }, "errors": { "type": "object" } } }, "SuccessResponse": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "message": { "type": "string" }, "data": { "type": "object" } } } } }, "paths": { "/auth/register": { "post": { "summary": "Register new user", "tags": [ "Authentication" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "email", "password", "preferred_currency" ], "properties": { "name": { "type": "string" }, "email": { "type": "string", "format": "email" }, "phone": { "type": "string" }, "password": { "type": "string", "minLength": 8 }, "password_confirmation": { "type": "string" }, "preferred_currency": { "type": "string", "length": 3, "enum": [ "AOA", "USD", "EUR", "ZAR" ] }, "device_id": { "type": "string" } } } } } }, "responses": { "201": { "description": "User registered successfully", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } }, "422": { "description": "Validation error", "content": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "/auth/login": { "post": { "summary": "User login", "tags": [ "Authentication" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "password", "device_id" ], "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string" }, "device_id": { "type": "string" } } } } } }, "responses": { "200": { "description": "Login successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } }, "401": { "description": "Invalid credentials", "content": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "/auth/logout": { "post": { "summary": "User logout", "tags": [ "Authentication" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Logout successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/auth/otp/send": { "post": { "summary": "Send OTP for verification", "tags": [ "Authentication" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "purpose" ], "properties": { "email": { "type": "string", "format": "email" }, "phone": { "type": "string" }, "purpose": { "type": "string", "enum": [ "login", "registration", "password_reset" ] } } } } } }, "responses": { "200": { "description": "OTP sent successfully", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/auth/otp/verify": { "post": { "summary": "Verify OTP code", "tags": [ "Authentication" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "code", "purpose" ], "properties": { "email": { "type": "string", "format": "email" }, "code": { "type": "string", "length": 6 }, "purpose": { "type": "string" } } } } } }, "responses": { "200": { "description": "OTP verified successfully", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/auth/pin/create": { "post": { "summary": "Create security PIN", "tags": [ "Authentication" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "pin", "confirm_pin" ], "properties": { "pin": { "type": "string", "length": 4, "pattern": "^\\d{4}$" }, "confirm_pin": { "type": "string" } } } } } }, "responses": { "200": { "description": "PIN created successfully", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/balance": { "get": { "summary": "Get user wallet balances", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Wallet balances retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/transactions": { "get": { "summary": "Get wallet transaction history", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "type", "in": "query", "schema": { "type": "string" } }, { "name": "status", "in": "query", "schema": { "type": "string" } }, { "name": "currency", "in": "query", "schema": { "type": "string" } }, { "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } } ], "responses": { "200": { "description": "Transaction history retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/deposit": { "post": { "summary": "Deposit funds to wallet", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "currency", "payment_method" ], "properties": { "amount": { "type": "number", "minimum": 1, "maximum": 100000 }, "currency": { "type": "string", "length": 3, "enum": [ "AOA", "USD", "EUR", "ZAR" ] }, "payment_method": { "type": "string" }, "reference": { "type": "string" } } } } } }, "responses": { "201": { "description": "Deposit successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/withdraw": { "post": { "summary": "Withdraw funds from wallet", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "currency", "linked_account_id" ], "properties": { "amount": { "type": "number", "minimum": 1, "maximum": 100000 }, "currency": { "type": "string", "length": 3, "enum": [ "AOA", "USD", "EUR", "ZAR" ] }, "linked_account_id": { "type": "integer" }, "notes": { "type": "string" } } } } } }, "responses": { "201": { "description": "Withdrawal successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/transfer": { "post": { "summary": "Transfer funds between users", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "recipient_email", "amount", "currency" ], "properties": { "recipient_email": { "type": "string", "format": "email" }, "amount": { "type": "number", "minimum": 0.01, "maximum": 1000 }, "currency": { "type": "string", "length": 3, "enum": [ "AOA", "USD", "EUR", "ZAR" ] }, "notes": { "type": "string" } } } } } }, "responses": { "200": { "description": "Transfer successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/transfer-savings": { "post": { "summary": "Transfer between user's own wallets", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "from_wallet_id", "to_wallet_id", "amount" ], "properties": { "from_wallet_id": { "type": "integer" }, "to_wallet_id": { "type": "integer" }, "amount": { "type": "number", "minimum": 0.01 }, "notes": { "type": "string" } } } } } }, "responses": { "200": { "description": "Transfer successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/wallet/send": { "post": { "summary": "Send funds to external account", "tags": [ "Wallet" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "amount", "currency", "recipient_account" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string", "length": 3 }, "recipient_account": { "type": "string" }, "recipient_name": { "type": "string" }, "notes": { "type": "string" } } } } } }, "responses": { "200": { "description": "Send successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/rates": { "get": { "summary": "Get current exchange rates", "tags": [ "Exchange" ], "parameters": [ { "name": "base_currency", "in": "query", "schema": { "type": "string", "default": "AOA" } }, { "name": "target_currencies", "in": "query", "schema": { "type": "array", "items": { "type": "string" } } } ], "responses": { "200": { "description": "Exchange rates retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/instant/request": { "post": { "summary": "Create instant exchange request", "tags": [ "Exchange" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "from_currency", "to_currency", "amount" ], "properties": { "from_currency": { "type": "string", "length": 3, "enum": [ "AOA", "USD", "EUR", "ZAR" ] }, "to_currency": { "type": "string", "length": 3, "enum": [ "AOA", "USD", "EUR", "ZAR" ] }, "amount": { "type": "number", "minimum": 100, "maximum": 10000000 }, "notes": { "type": "string" } } } } } }, "responses": { "201": { "description": "Exchange request created", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/instant/requests": { "get": { "summary": "Get user's exchange requests", "tags": [ "Exchange" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string" } }, { "name": "from_currency", "in": "query", "schema": { "type": "string" } }, { "name": "to_currency", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Exchange requests retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/liquidity/{currency}": { "get": { "summary": "Check liquidity status for currency", "tags": [ "Exchange" ], "parameters": [ { "name": "currency", "in": "path", "required": true, "schema": { "type": "string", "length": 3 } } ], "responses": { "200": { "description": "Liquidity status retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/p2p/listings": { "get": { "summary": "Get P2P listings", "tags": [ "Exchange" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "P2P listings retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/p2p/create": { "post": { "summary": "Create P2P listing", "tags": [ "Exchange" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "from_currency", "to_currency", "amount", "base_rate" ], "properties": { "from_currency": { "type": "string", "length": 3 }, "to_currency": { "type": "string", "length": 3 }, "amount": { "type": "number" }, "min_amount": { "type": "number" }, "max_amount": { "type": "number" }, "base_rate": { "type": "number" }, "margin_percentage": { "type": "number" }, "payment_methods": { "type": "array", "items": { "type": "string" } }, "notes": { "type": "string" } } } } } }, "responses": { "201": { "description": "P2P listing created", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/exchange/p2p/accept": { "post": { "summary": "Accept P2P listing", "tags": [ "Exchange" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "listing_id", "amount", "delivery_method" ], "properties": { "listing_id": { "type": "integer" }, "amount": { "type": "number" }, "delivery_method": { "type": "string" }, "delivery_details": { "type": "object" } } } } } }, "responses": { "201": { "description": "P2P order created", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/user/profile": { "get": { "summary": "Get user profile", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "User profile retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "put": { "summary": "Update user profile", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "phone": { "type": "string" }, "preferred_currency": { "type": "string", "length": 3 } } } } } }, "responses": { "200": { "description": "Profile updated", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/user/verification": { "get": { "summary": "Get user verification status", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Verification status retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "post": { "summary": "Submit KYC verification documents", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "id_document_type", "id_document_number", "id_document", "selfie" ], "properties": { "id_document_type": { "type": "string", "enum": [ "passport", "national_id", "drivers_license" ] }, "id_document_number": { "type": "string" }, "id_document": { "type": "string", "format": "binary" }, "selfie": { "type": "string", "format": "binary" }, "address_proof": { "type": "string", "format": "binary" } } } } } }, "responses": { "201": { "description": "Verification submitted", "content": { "schema": { "$ref": "#components/schemas/SuccessResponse" } } } } } }, "/user/linked-accounts": { "get": { "summary": "Get linked accounts", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Linked accounts retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "post": { "summary": "Add linked account", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "account_type", "account_holder_name", "account_number" ], "properties": { "account_type": { "type": "string" }, "account_holder_name": { "type": "string" }, "account_number": { "type": "string" }, "bank_name": { "type": "string" }, "is_default": { "type": "boolean" } } } } } }, "responses": { "201": { "description": "Account linked", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/user/recipients": { "get": { "summary": "Get saved recipients", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Recipients retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "post": { "summary": "Add new recipient", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "account_number", "bank_name" ], "properties": { "name": { "type": "string" }, "account_number": { "type": "string" }, "bank_name": { "type": "string" }, "currency": { "type": "string", "length": 3 } } } } } }, "responses": { "201": { "description": "Recipient added", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/user/security": { "get": { "summary": "Get security settings", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Security settings retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "put": { "summary": "Update security settings", "tags": [ "User" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "biometric_enabled": { "type": "boolean" }, "device_whitelist_enabled": { "type": "boolean" }, "transaction_notifications": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "Security settings updated", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/notifications": { "get": { "summary": "Get user notifications", "tags": [ "Notifications" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Notifications retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/notifications/unread-count": { "get": { "summary": "Get unread notification count", "tags": [ "Notifications" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Unread count retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/notifications/read-all": { "put": { "summary": "Mark all notifications as read", "tags": [ "Notifications" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "All notifications marked as read", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/support/chat": { "post": { "summary": "Create support chat", "tags": [ "Support" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "subject", "message" ], "properties": { "subject": { "type": "string" }, "message": { "type": "string" }, "category": { "type": "string" } } } } } }, "responses": { "201": { "description": "Support chat created", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/support/faq": { "get": { "summary": "Get FAQ items", "tags": [ "Support" ], "responses": { "200": { "description": "FAQ retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/currencies": { "get": { "summary": "Get supported currencies", "tags": [ "System" ], "responses": { "200": { "description": "Currencies retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/health": { "get": { "summary": "API health check", "tags": [ "System" ], "responses": { "200": { "description": "API is healthy", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/auth/login": { "post": { "summary": "Admin login", "tags": [ "Admin" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "password" ], "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string" } } } } } }, "responses": { "200": { "description": "Admin login successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/auth/logout": { "post": { "summary": "Admin logout", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Admin logout successful", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/dashboard/stats": { "get": { "summary": "Get dashboard statistics", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Dashboard stats retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/users": { "get": { "summary": "Get all users", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Users retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/users/{id}": { "get": { "summary": "Get user details", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "User details retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/users/{id}/suspend": { "post": { "summary": "Suspend user account", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "User suspended", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/users/{id}/activate": { "post": { "summary": "Activate user account", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "User activated", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/users/{id}/verify": { "post": { "summary": "Approve user KYC verification", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "User verified", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/transactions": { "get": { "summary": "Get all transactions", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Transactions retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/verifications/pending": { "get": { "summary": "Get pending verifications", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Pending verifications retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } } }, "/admin/settings": { "get": { "summary": "Get system settings", "tags": [ "Admin" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Settings retrieved", "content": { "schema": { "$ref": "#/components/schemas/SuccessResponse" } } } } }, "put": { "summary": "PUT /admin/settings", "operationId": "putAdminSettings", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/auth/social/apple": { "post": { "summary": "POST /auth/social/apple", "operationId": "postAuthSocialApple", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/auth/social/google": { "post": { "summary": "POST /auth/social/google", "operationId": "postAuthSocialGoogle", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/exchange/instant/requests/{id}/cancel": { "put": { "summary": "PUT /exchange/instant/requests/{id}/cancel", "operationId": "putExchangeInstantRequestsIdCancel", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } }, "security": [ { "bearerAuth": [] } ] } }, "/user/pin/change": { "post": { "summary": "POST /user/pin/change", "operationId": "postUserPinChange", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } }, "security": [ { "bearerAuth": [] } ] } }, "/user/linked-accounts/{id}": { "delete": { "summary": "DELETE /user/linked-accounts/{id}", "operationId": "deleteUserLinked-accountsId", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } }, "security": [ { "bearerAuth": [] } ] } }, "/notifications/{id}/read": { "put": { "summary": "PUT /notifications/{id}/read", "operationId": "putNotificationsIdRead", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } }, "security": [ { "bearerAuth": [] } ] } }, "/support/faq/search": { "get": { "summary": "GET /support/faq/search", "operationId": "getSupportFaqSearch", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/support/chat/{id}": { "get": { "summary": "GET /support/chat/{id}", "operationId": "getSupportChatId", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } }, "security": [ { "bearerAuth": [] } ] } }, "/support/chat/{id}/message": { "post": { "summary": "POST /support/chat/{id}/message", "operationId": "postSupportChatIdMessage", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } }, "security": [ { "bearerAuth": [] } ] } }, "/admin/dashboard/recent-activity": { "get": { "summary": "GET /admin/dashboard/recent-activity", "operationId": "getAdminDashboardRecent-activity", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/dashboard/analytics": { "get": { "summary": "GET /admin/dashboard/analytics", "operationId": "getAdminDashboardAnalytics", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/users/{id}/transactions": { "get": { "summary": "GET /admin/users/{id}/transactions", "operationId": "getAdminUsersIdTransactions", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/users/{id}/security-logs": { "get": { "summary": "GET /admin/users/{id}/security-logs", "operationId": "getAdminUsersIdSecurity-logs", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/users/{id}/wallets": { "get": { "summary": "GET /admin/users/{id}/wallets", "operationId": "getAdminUsersIdWallets", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/exchange/requests": { "get": { "summary": "GET /admin/exchange/requests", "operationId": "getAdminExchangeRequests", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/exchange/requests/{id}": { "get": { "summary": "GET /admin/exchange/requests/{id}", "operationId": "getAdminExchangeRequestsId", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/exchange/requests/{id}/approve": { "post": { "summary": "POST /admin/exchange/requests/{id}/approve", "operationId": "postAdminExchangeRequestsIdApprove", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/exchange/requests/{id}/reject": { "post": { "summary": "POST /admin/exchange/requests/{id}/reject", "operationId": "postAdminExchangeRequestsIdReject", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/exchange/rates": { "get": { "summary": "GET /admin/exchange/rates", "operationId": "getAdminExchangeRates", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } }, "post": { "summary": "POST /admin/exchange/rates", "operationId": "postAdminExchangeRates", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/verifications/{id}": { "get": { "summary": "GET /admin/verifications/{id}", "operationId": "getAdminVerificationsId", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/verifications/{id}/approve": { "post": { "summary": "POST /admin/verifications/{id}/approve", "operationId": "postAdminVerificationsIdApprove", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/verifications/{id}/reject": { "post": { "summary": "POST /admin/verifications/{id}/reject", "operationId": "postAdminVerificationsIdReject", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/verifications/{id}/documents": { "get": { "summary": "GET /admin/verifications/{id}/documents", "operationId": "getAdminVerificationsIdDocuments", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/transactions/{id}": { "get": { "summary": "GET /admin/transactions/{id}", "operationId": "getAdminTransactionsId", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/transactions/{id}/flag": { "post": { "summary": "POST /admin/transactions/{id}/flag", "operationId": "postAdminTransactionsIdFlag", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/transactions/{id}/investigate": { "post": { "summary": "POST /admin/transactions/{id}/investigate", "operationId": "postAdminTransactionsIdInvestigate", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/transactions/{id}/refund": { "post": { "summary": "POST /admin/transactions/{id}/refund", "operationId": "postAdminTransactionsIdRefund", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/p2p/listings": { "get": { "summary": "GET /admin/p2p/listings", "operationId": "getAdminP2pListings", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/p2p/orders": { "get": { "summary": "GET /admin/p2p/orders", "operationId": "getAdminP2pOrders", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/p2p/listings/{id}/approve": { "post": { "summary": "POST /admin/p2p/listings/{id}/approve", "operationId": "postAdminP2pListingsIdApprove", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/p2p/listings/{id}/reject": { "post": { "summary": "POST /admin/p2p/listings/{id}/reject", "operationId": "postAdminP2pListingsIdReject", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/p2p/orders/{id}/dispute": { "post": { "summary": "POST /admin/p2p/orders/{id}/dispute", "operationId": "postAdminP2pOrdersIdDispute", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/settings/fees": { "get": { "summary": "GET /admin/settings/fees", "operationId": "getAdminSettingsFees", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } }, "put": { "summary": "PUT /admin/settings/fees", "operationId": "putAdminSettingsFees", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/support/chats": { "get": { "summary": "GET /admin/support/chats", "operationId": "getAdminSupportChats", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/support/chats/{id}": { "get": { "summary": "GET /admin/support/chats/{id}", "operationId": "getAdminSupportChatsId", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/support/chats/{id}/message": { "post": { "summary": "POST /admin/support/chats/{id}/message", "operationId": "postAdminSupportChatsIdMessage", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } }, "/admin/activity-logs": { "get": { "summary": "GET /admin/activity-logs", "operationId": "getAdminActivity-logs", "responses": { "200": { "description": "Successful response" }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation failed" } } } } }, "tags": [ { "name": "Authentication", "description": "User authentication endpoints" }, { "name": "Wallet", "description": "Wallet management endpoints" }, { "name": "Exchange", "description": "Currency exchange endpoints" }, { "name": "User", "description": "User profile and settings endpoints" }, { "name": "Notifications", "description": "Notification management endpoints" }, { "name": "Support", "description": "Customer support endpoints" }, { "name": "System", "description": "System information endpoints" }, { "name": "Admin", "description": "Admin panel endpoints" } ] }