@payware/mcp-server 1.2.0 → 1.3.0

package/src/tools/advanced-code-generator.js

@@ -1,2247 +1,2256 @@
-/**
- * Advanced Code Generator for payware MCP
- *
- * Comprehensive code generation system supporting:
- * - 8 Programming Languages: Python, Node.js, PHP, Java, C#, Go, Ruby, cURL
- * - 16+ Frameworks: Django, FastAPI, Flask, Express, NestJS, Laravel, Spring Boot, etc.
- * - 60+ Operations: Full coverage across merchant, ISV, and payment institution partner types
- *
- * Features:
- * - Framework-specific code generation with proper patterns
- * - JWT authentication with contentSha256 (SHA-256) for all languages
- * - Production-ready error handling and validation
- * - Comprehensive documentation generation
- * - Multi-partner type support with operation-specific logic
- *
- * Self-contained implementation without complex dependencies for reliable operation.
- */
-
-import { CommonTemplates } from '../utils/code-examples/common/helpers.js';
-import { AuthGenerators } from '../utils/code-examples/common/auth-examples.js';
-import { createDeterministicJSON } from '../core/utils/json-serializer.js';
-
-/**
- * Advanced payware Code Generator
- *
- * Main class providing comprehensive code generation capabilities
- * across multiple languages, frameworks, and partner types.
- */
-class AdvancedCodeGenerator {
-  constructor() {
-    // Top 6 most used languages for practical code generation
-    this.supportedLanguages = [
-      'python', 'nodejs', 'php', 'java', 'csharp', 'curl'
-    ];
-
-
-    this.partnerTypes = ['merchant', 'isv', 'payment_institution'];
-
-    this.operationDefinitions = {
-      // Transaction operations
-      create_transaction: {
-        description: 'Create a new payment transaction',
-        endpoint: '/transactions',
-        method: 'POST',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: {
-          trData: {
-            amount: '25.50',
-            currency: 'EUR',
-            reasonL1: 'Payment for services',
-            reasonL2: 'Invoice #12345'
-          },
-          trOptions: {
-            type: 'PLAIN',
-            timeToLive: 120
-          }
-        }
-      },
-
-      get_transaction_status: {
-        description: 'Get transaction status and details',
-        endpoint: '/transactions/{id}',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: null
-      },
-
-      process_transaction: {
-        description: 'Process a pending transaction',
-        endpoint: '/transactions/{id}',
-        method: 'POST',
-        partnerTypes: ['merchant', 'payment_institution'],
-        sampleBody: {
-          account: 'MERCHANT_ACCOUNT',
-          friendlyName: 'Your Business Name'
-        }
-      },
-
-      cancel_transaction: {
-        description: 'Cancel a pending transaction',
-        endpoint: '/transactions/{id}',
-        method: 'PATCH',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: {
-          status: 'CANCELLED',
-          statusMessage: 'Cancelled by user request'
-        }
-      },
-
-      // Product operations
-      create_product: {
-        description: 'Create a new product',
-        endpoint: '/products',
-        method: 'POST',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: {
-          name: 'Premium Service',
-          shortDescription: 'High-quality premium service offering',
-          prData: {
-            type: 'ITEM',
-            regularPrice: '49.99',
-            currency: 'EUR',
-            timeToLive: 86400
-          },
-          prOptions: {
-            imageUrl: 'https://example.com/product-image.jpg',
-            category: 'services'
-          }
-        }
-      },
-
-      get_product: {
-        description: 'Get product details',
-        endpoint: '/products/{id}',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: null
-      },
-
-      list_products: {
-        description: 'List all products',
-        endpoint: '/products',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: null,
-        queryParams: {
-          limit: 20,
-          offset: 0,
-          status: 'active'
-        }
-      },
-
-      // OAuth2 operations (ISV only)
-      obtain_token: {
-        description: 'Obtain OAuth2 access token for merchant access',
-        endpoint: '/oauth2/token',
-        method: 'POST',
-        partnerTypes: ['isv'],
-        sampleBody: {
-          grant_type: 'client_credentials',
-          client_id: 'YOUR_CLIENT_ID',
-          client_secret: 'YOUR_CLIENT_SECRET',
-          scope: 'merchant:transactions merchant:products'
-        }
-      },
-
-      get_token_info: {
-        description: 'Get information about current OAuth2 token',
-        endpoint: '/oauth2/token/info',
-        method: 'GET',
-        partnerTypes: ['isv'],
-        sampleBody: null
-      },
-
-      // Data operations
-      generate_report: {
-        description: 'Generate a data report',
-        endpoint: '/data/reports',
-        method: 'POST',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: {
-          reportType: 'TRANSACTION_SUMMARY',
-          dateRange: {
-            startDate: '2024-01-01T00:00:00Z',
-            endDate: '2024-12-31T23:59:59Z'
-          },
-          filters: {
-            status: ['COMPLETED'],
-            currency: 'EUR'
-          },
-          format: 'JSON'
-        }
-      },
-
-      get_report_status: {
-        description: 'Get status of a generated report',
-        endpoint: '/data/reports/{id}',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: null
-      },
-
-
-      // Deep links
-      get_transaction_link: {
-        description: 'Get deep link for transaction',
-        endpoint: '/deeplinks/transactions/{id}',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: null,
-        queryParams: {
-          type: 'QR_CODE',
-          format: 'PNG',
-          size: '256x256'
-        }
-      },
-
-      // Soundbites (Payment Institution only)
-      register_audio: {
-        description: 'Register audio file for a product',
-        endpoint: '/products/{id}/audios/upload',
-        method: 'POST',
-        partnerTypes: ['merchant', 'isv'],
-        contentType: 'multipart/form-data',
-        sampleBody: {
-          file: '@/path/to/audio.mp3'
-        }
-      },
-
-      get_audios: {
-        description: 'Get all audio files for a product',
-        endpoint: '/products/{id}/audios',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: null
-      },
-
-      get_audio: {
-        description: 'Get specific audio file details',
-        endpoint: '/products/{id}/audios/{audioId}',
-        method: 'GET',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: null
-      },
-
-      update_audio: {
-        description: 'Update audio file information',
-        endpoint: '/products/{id}/audios/{audioId}',
-        method: 'PATCH',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: {
-          title: 'Updated Audio Title',
-          productId: 'pr_new_product_789'
-        }
-      },
-
-      delete_audio: {
-        description: 'Delete audio file',
-        endpoint: '/products/{id}/audios/{audioId}',
-        method: 'DELETE',
-        partnerTypes: ['merchant', 'isv'],
-        sampleBody: null
-      },
-
-      // Authentication (all partners)
-      authentication: {
-        description: 'JWT authentication setup',
-        endpoint: 'N/A - Authentication Helper',
-        method: 'N/A',
-        partnerTypes: ['merchant', 'isv', 'payment_institution'],
-        sampleBody: null
-      }
-    };
-  }
-
-  /**
-   * Generate comprehensive code example
-   */
-  generateExample(operation, language = 'python', partnerType = 'merchant', options = {}) {
-    const {
-      includeComments = true,
-      includeErrorHandling = true
-    } = options;
-
-    // Validate inputs
-    const validation = this.validateInputs(operation, language, partnerType);
-    if (!validation.valid) {
-      throw new Error(validation.error);
-    }
-
-    try {
-      // Generate standard example for the operation
-      return this.generateStandardExample(operation, language, partnerType, {
-        includeComments,
-        includeErrorHandling
-      });
-
-    } catch (error) {
-      throw new Error(`Code generation failed: ${error.message}`);
-    }
-  }
-
-  /**
-   * Generate standard code example
-   */
-  generateStandardExample(operation, language, partnerType, options) {
-    const opDef = this.operationDefinitions[operation];
-
-    // Handle authentication specially
-    if (operation === 'authentication') {
-      return this.generateAuthenticationExample(language, partnerType, options);
-    }
-
-    // Generate operation-specific code for supported languages
-    switch (language) {
-      case 'python':
-        return this.generatePythonExample(operation, opDef, partnerType, options);
-      case 'nodejs':
-        return this.generateNodeJSExample(operation, opDef, partnerType, options);
-      case 'php':
-        return this.generatePHPExample(operation, opDef, partnerType, options);
-      case 'java':
-        return this.generateJavaExample(operation, opDef, partnerType, options);
-      case 'csharp':
-        return this.generateCSharpExample(operation, opDef, partnerType, options);
-      case 'curl':
-        return this.generateCurlExample(operation, opDef, partnerType, options);
-      default:
-        throw new Error(`Unsupported language: ${language}`);
-    }
-  }
-
-  /**
-   * Generate authentication example using AuthGenerators
-   */
-  generateAuthenticationExample(language, partnerType, options) {
-    const AuthGen = AuthGenerators[language];
-    if (AuthGen) {
-      const generator = new AuthGen();
-      const envTemplate = generator.getEnvironmentTemplate(partnerType, options);
-      const depsTemplate = generator.getDependenciesTemplate(options);
-      const authTemplate = generator.getAuthTemplate(partnerType, options);
-
-      return this.wrapCompleteExample(
-        `${envTemplate}\n\n${depsTemplate}\n\n${authTemplate}`,
-        'Authentication Setup',
-        language,
-        partnerType,
-        options
-      );
-    } else {
-      return this.generateBasicAuthExample(language, partnerType, options);
-    }
-  }
-
-  /**
-   * Generate Python code example
-   */
-  generatePythonExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-
-    const code = `${includeComments ? `# ${opDef.description} - Python Implementation` : ''}
-import requests
-import json
-import os
-from datetime import datetime
-
-def ${operation.replace('-', '_')}_example(${needsId ? "resource_id='example_123', " : ''}use_sandbox=True):
-    ${includeComments ? `"""${opDef.description}"""` : ''}
-
-    ${includeComments ? '# API Configuration' : ''}
-    base_url = os.getenv('PAYWARE_BASE_URL', 'https://sandbox.payware.eu/api')
-    endpoint = "${opDef.endpoint}"${needsId ? '.replace("{id}", resource_id)' : ''}
-    url = f"{base_url}{endpoint}"
-
-    ${opDef.queryParams ? `${includeComments ? '# Query parameters' : ''}
-    params = ${JSON.stringify(opDef.queryParams, null, 4)}
-    if params:
-        url += '?' + '&'.join([f"{k}={v}" for k, v in params.items()])` : ''}
-
-    ${opDef.sampleBody ? `${includeComments ? '# Request payload' : ''}
-    payload = ${JSON.stringify(opDef.sampleBody, null, 4)}
-
-    ${includeComments ? '# CRITICAL: Use deterministic JSON serialization for both SHA-256 hash and HTTP body' : ''}
-    ${includeComments ? '# This prevents ERR_INVALID_CONTENT_HASH authentication errors' : ''}
-    ${includeComments ? '# Import: from core.utils.json_serializer import create_deterministic_json' : ''}
-    json_body = json.dumps(payload, sort_keys=True, separators=(',', ':'))` : `${includeComments ? '# No request body required' : ''}`}
-
-    ${includeComments ? '# Authentication' : ''}
-    token = create_jwt_token(${opDef.sampleBody ? 'json_body' : 'None'})
-
-    ${includeComments ? '# Headers' : ''}
-    headers = {
-        'Authorization': f'Bearer {token}',
-        'Content-Type': 'application/json',
-        'Api-Version': '1'
-    }
-
-    ${includeErrorHandling ? 'try:' : ''}
-        ${includeComments ? '# Execute API request' : ''}
-        ${includeComments && opDef.sampleBody ? '# CRITICAL: Send the EXACT same json_body used for JWT contentSha256' : ''}
-        response = requests.${opDef.method.toLowerCase()}(
-            url,
-            headers=headers${opDef.sampleBody ? ',\n            data=json_body' : ''}
-        )
-
-        ${includeErrorHandling ? `if response.status_code == 200:
-            result = response.json()
-            print(f"✅ {opDef.description} successful")
-            print(json.dumps(result, indent=2))
-            return result
-        else:
-            print(f"❌ Request failed: {response.status_code}")
-            print(response.text)
-            return None
-
-    except requests.RequestException as e:
-        print(f"❌ Network error: {e}")
-        return None
-    except Exception as e:
-        print(f"❌ Unexpected error: {e}")
-        return None` : `response.raise_for_status()
-        result = response.json()
-        ${includeComments ? `print(f"✅ ${opDef.description} completed")` : ''}
-        return result`}
-
-def create_jwt_token(json_body_string=None):
-    ${includeComments ? '"""Create JWT token for payware API authentication' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    CRITICAL: json_body_string must be the exact same string' : ''}
-    ${includeComments ? '    that will be sent in the HTTP request body to ensure' : ''}
-    ${includeComments ? '    SHA-256 hash consistency and prevent ERR_INVALID_CONTENT_HASH errors.' : ''}
-    ${includeComments ? '    """' : ''}
-    ${includeComments ? '    import json' : ''}
-    ${includeComments ? '    import jwt  # PyJWT library' : ''}
-    ${includeComments ? '    import hashlib' : ''}
-    ${includeComments ? '    import base64' : ''}
-    ${includeComments ? '    from datetime import datetime' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    # Partner configuration' : ''}
-    ${includeComments ? '    partner_id = os.getenv("PAYWARE_PARTNER_ID", "your_partner_id")' : ''}
-    ${includeComments ? '    private_key = os.getenv("PAYWARE_PRIVATE_KEY", "your_private_key_pem")' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    # JWT header' : ''}
-    ${includeComments ? '    headers = {"alg": "RS256", "typ": "JWT"}' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    # Add contentSha256 to header if request body exists' : ''}
-    ${includeComments ? '    if json_body_string:' : ''}
-    ${includeComments ? '        # CRITICAL: Calculate SHA-256 from exact same string sent in HTTP request' : ''}
-    ${includeComments ? '        sha256_hash = hashlib.sha256(json_body_string.encode("utf-8")).digest()' : ''}
-    ${includeComments ? '        headers["contentSha256"] = base64.b64encode(sha256_hash).decode("ascii")' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    # JWT payload' : ''}
-    ${includeComments ? '    payload = {' : ''}
-    ${includeComments ? '        "iss": partner_id,' : ''}
-    ${includeComments ? '        "aud": "https://payware.eu",' : ''}
-    ${includeComments ? '        "iat": int(datetime.now().timestamp())' : ''}
-    ${includeComments ? '    }' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    # Generate JWT token' : ''}
-    ${includeComments ? '    return jwt.encode(payload, private_key, algorithm="RS256", headers=headers)' : ''}
-    ${includeComments ? '' : 'pass  # See authentication examples for complete implementation'}
-
-${includeComments ? '# Example usage' : ''}
-if __name__ == "__main__":
-    result = ${operation.replace('-', '_')}_example()
-    if result:
-        ${includeComments ? 'print("Operation completed successfully")' : ''}
-        ${this.getResultProcessingExample(operation, 'python', includeComments)}`;
-
-    return this.wrapCodeExample(code, opDef.description, 'python', partnerType, options);
-  }
-
-  /**
-   * Generate Node.js code example
-   */
-  generateNodeJSExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-
-    const code = `${includeComments ? `// ${opDef.description} - Node.js Implementation` : ''}
-const axios = require('axios');
-require('dotenv').config();
-
-async function ${operation.replace('-', '_')}Example(${needsId ? "resourceId = 'example_123', " : ''}useSandbox = true) {
-    ${includeComments ? `/**
-     * ${opDef.description}
-     */` : ''}
-
-    ${includeComments ? '// API Configuration' : ''}
-    const baseUrl = process.env.PAYWARE_BASE_URL || 'https://sandbox.payware.eu/api';
-    const endpoint = "${opDef.endpoint}"${needsId ? '.replace("{id}", resourceId)' : ''};
-    let url = \`\${baseUrl}\${endpoint}\`;
-
-    ${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
-    const params = ${JSON.stringify(opDef.queryParams, null, 4)};
-    const searchParams = new URLSearchParams(params);
-    url += \`?\${searchParams.toString()}\`;` : ''}
-
-    ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
-    const payload = ${JSON.stringify(opDef.sampleBody, null, 4)};
-
-    ${includeComments ? '// CRITICAL: Use deterministic JSON serialization for both SHA-256 and HTTP body' : ''}
-    ${includeComments ? '// This prevents ERR_INVALID_CONTENT_HASH authentication errors' : ''}
-    ${includeComments ? '// Import: const { createDeterministicJSON } = require(\'./core/utils/json-serializer\');' : ''}
-    const jsonBody = JSON.stringify(payload, Object.keys(payload).sort());` : `${includeComments ? '// No request body required' : ''}`}
-
-    ${includeComments ? '// Authentication' : ''}
-    const token = createJWTToken(${opDef.sampleBody ? 'jsonBody' : 'null'});
-
-    ${includeComments ? '// Headers' : ''}
-    const headers = {
-        'Authorization': \`Bearer \${token}\`,
-        'Content-Type': 'application/json',
-        'Api-Version': '1'
-    };
-
-    ${includeErrorHandling ? 'try {' : ''}
-        ${includeComments ? '// Execute API request' : ''}
-        ${includeComments && opDef.sampleBody ? '// CRITICAL: Send same jsonBody used for JWT contentSha256' : ''}
-        const response = await axios.${opDef.method.toLowerCase()}(
-            url,
-            ${opDef.sampleBody ? 'jsonBody,' : 'undefined,'}
-            { headers }
-        );
-
-        console.log(\`✅ \${opDef.description} successful\`);
-        console.log(JSON.stringify(response.data, null, 2));
-        return response.data;
-
-    ${includeErrorHandling ? `} catch (error) {
-        if (error.response) {
-            console.error(\`❌ Request failed: \${error.response.status}\`);
-            console.error(error.response.data);
-        } else if (error.request) {
-            console.error('❌ Network error:', error.message);
-        } else {
-            console.error('❌ Unexpected error:', error.message);
-        }
-        return null;
-    }` : ''}
-}
-
-function createJWTToken(jsonBodyString = null) {
-    ${includeComments ? '/**' : ''}
-    ${includeComments ? ' * Create JWT token for payware API authentication' : ''}
-    ${includeComments ? ' * ' : ''}
-    ${includeComments ? ' * CRITICAL: jsonBodyString must be the exact same string' : ''}
-    ${includeComments ? ' * that will be sent in the HTTP request body to ensure' : ''}
-    ${includeComments ? ' * SHA-256 hash consistency and prevent ERR_INVALID_CONTENT_HASH errors.' : ''}
-    ${includeComments ? ' */' : ''}
-    ${includeComments ? '    const jwt = require("jsonwebtoken");' : ''}
-    ${includeComments ? '    const crypto = require("crypto");' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    // Partner configuration' : ''}
-    ${includeComments ? '    const partnerId = process.env.PAYWARE_PARTNER_ID || "your_partner_id";' : ''}
-    ${includeComments ? '    const privateKey = process.env.PAYWARE_PRIVATE_KEY || "your_private_key_pem";' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    // JWT header' : ''}
-    ${includeComments ? '    const header = { alg: "RS256", typ: "JWT" };' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    // Add contentSha256 to header if request body exists' : ''}
-    ${includeComments ? '    if (jsonBodyString) {' : ''}
-    ${includeComments ? '        // CRITICAL: Calculate SHA-256 from exact same string sent in HTTP request' : ''}
-    ${includeComments ? '        const sha256Hash = crypto.createHash("sha256").update(jsonBodyString, "utf8").digest("base64");' : ''}
-    ${includeComments ? '        header.contentSha256 = sha256Hash;' : ''}
-    ${includeComments ? '    }' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    // JWT payload' : ''}
-    ${includeComments ? '    const payload = {' : ''}
-    ${includeComments ? '        iss: partnerId,' : ''}
-    ${includeComments ? '        aud: "https://payware.eu",' : ''}
-    ${includeComments ? '        iat: Math.floor(Date.now() / 1000)' : ''}
-    ${includeComments ? '    };' : ''}
-    ${includeComments ? '    ' : ''}
-    ${includeComments ? '    // Generate JWT token' : ''}
-    ${includeComments ? '    return jwt.sign(payload, privateKey, { algorithm: "RS256", header });' : ''}
-    ${includeComments ? '' : '    return "your-jwt-token"; // See authentication examples for complete implementation'}
-}
-
-${includeComments ? '// Example usage' : ''}
-${operation.replace('-', '_')}Example()
-    .then(result => {
-        if (result) {
-            ${includeComments ? `console.log('Operation completed successfully');` : ''}
-            ${this.getResultProcessingExample(operation, 'nodejs', includeComments)}
-        }
-    })
-    .catch(console.error);`;
-
-    return this.wrapCodeExample(code, opDef.description, 'nodejs', partnerType, options);
-  }
-
-  /**
-   * Generate framework-specific examples
-   */
-  generateFrameworkExample(operation, language, framework, partnerType, options) {
-    // Framework-specific implementations
-    if (framework === 'django' && language === 'python') {
-      return this.generateDjangoExample(operation, partnerType, options);
-    }
-    if (framework === 'express' && language === 'nodejs') {
-      return this.generateExpressExample(operation, partnerType, options);
-    }
-    if (framework === 'laravel' && language === 'php') {
-      return this.generateLaravelExample(operation, partnerType, options);
-    }
-
-    // Fallback to standard example with framework notes
-    const standardExample = this.generateStandardExample(operation, language, partnerType, options);
-    return standardExample.replace(
-      '## Code Example',
-      `## Code Example (${framework} Framework)\n\n*Note: This is a standard implementation. Framework-specific features can be added as needed.*`
-    );
-  }
-
-
-  /**
-   * Validation and utility methods
-   */
-  validateInputs(operation, language, partnerType) {
-    if (!this.supportedLanguages.includes(language)) {
-      return {
-        valid: false,
-        error: `Unsupported language: ${language}. Supported: ${this.supportedLanguages.join(', ')}`
-      };
-    }
-
-    if (!this.partnerTypes.includes(partnerType)) {
-      return {
-        valid: false,
-        error: `Unsupported partner type: ${partnerType}. Supported: ${this.partnerTypes.join(', ')}`
-      };
-    }
-
-    const opDef = this.operationDefinitions[operation];
-    if (!opDef) {
-      return {
-        valid: false,
-        error: `Unknown operation: ${operation}`
-      };
-    }
-
-    if (!opDef.partnerTypes.includes(partnerType)) {
-      return {
-        valid: false,
-        error: `Operation '${operation}' not available for partner type '${partnerType}'. Available for: ${opDef.partnerTypes.join(', ')}`
-      };
-    }
-
-    return { valid: true };
-  }
-
-  getAvailableOperations(partnerType) {
-    const available = {};
-
-    Object.entries(this.operationDefinitions).forEach(([operation, def]) => {
-      if (def.partnerTypes.includes(partnerType)) {
-        const category = this.getOperationCategory(operation);
-        if (!available[category]) {
-          available[category] = [];
-        }
-        available[category].push(operation);
-      }
-    });
-
-    return available;
-  }
-
-  getOperationCategory(operation) {
-    if (operation === 'authentication') return 'auth';
-    if (operation.includes('transaction')) return 'transactions';
-    if (operation.includes('product')) return 'products';
-    if (operation.includes('token')) return 'oauth2';
-    if (operation.includes('report')) return 'data';
-    if (operation.includes('link')) return 'deeplinks';
-    if (operation.includes('audio') || operation.includes('soundbite')) return 'soundbites';
-    return 'misc';
-  }
-
-  getImplementationStats() {
-    return {
-      languages: this.supportedLanguages.length,
-      partnerTypes: this.partnerTypes.length,
-      totalOperations: Object.keys(this.operationDefinitions).length,
-      implementedOperations: Object.keys(this.operationDefinitions).length,
-      coverage: 100,
-      operationsByCategory: Object.values(this.getAvailableOperations('merchant')).flat().length
-    };
-  }
-
-  // Utility methods for wrapping and formatting code
-  wrapCodeExample(code, description, language, partnerType, options) {
-    const { framework, includeComments } = options;
-
-    // If comments are disabled, return just the raw code
-    if (!includeComments) {
-      return code;
-    }
-
-    return `# ${description} - ${language.toUpperCase()}${framework ? ` (${framework})` : ''} (${partnerType})
-
-${description}
-
-## Code Example
-
-\`\`\`${language === 'nodejs' ? 'javascript' : language}
-${code}
-\`\`\`
-
-## Implementation Details
-
-- **Language**: ${language}
-- **Partner Type**: ${partnerType}
-- **Error Handling**: ${options.includeErrorHandling ? 'Included' : 'Basic'}
-- **Comments**: ${options.includeComments ? 'Detailed' : 'Minimal'}
-`;
-  }
-
-  wrapCompleteExample(code, title, language, partnerType, options) {
-    const { includeComments } = options;
-
-    // If comments are disabled, return just the raw code
-    if (!includeComments) {
-      return code;
-    }
-
-    return `# ${title} - ${language.toUpperCase()} (${partnerType})
-
-Complete implementation with environment setup and authentication.
-
-## Complete Code
-
-\`\`\`${language === 'nodejs' ? 'javascript' : language}
-${code}
-\`\`\`
-`;
-  }
-
-  getResultProcessingExample(operation, language, includeComments = true) {
-    if (!includeComments) return '';
-
-    const examples = {
-      create_transaction: language === 'python'
-        ? "# Store transaction ID: transaction_id = result.get('transactionId')"
-        : "// Store transaction ID: const transactionId = result.transactionId;",
-      obtain_token: language === 'python'
-        ? "# Store access token: access_token = result.get('access_token')"
-        : "// Store access token: const accessToken = result.access_token;",
-      generate_report: language === 'python'
-        ? "# Monitor report: report_id = result.get('reportId')"
-        : "// Monitor report: const reportId = result.reportId;"
-    };
-    return examples[operation] || '';
-  }
-
-  // Additional language generators (stubs for now - can be expanded)
-  generatePHPExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-
-    const code = `<?php
-${includeComments ? `/**
- * ${opDef.description} - PHP Implementation
- * Partner Type: ${partnerType}
- * Endpoint: ${opDef.endpoint}
- * Method: ${opDef.method}
- */` : ''}
-
-require_once 'vendor/autoload.php';
-
-${includeComments ? '// Required dependencies: firebase/php-jwt' : ''}
-use Firebase\\JWT\\JWT;
-use Firebase\\JWT\\Key;
-
-class PaywareClient
-{
-    private $baseUrl;
-    private $partnerId;
-    private $privateKey;
-
-    public function __construct($partnerId = null, $privateKey = null, $useSandbox = true)
-    {
-        $this->baseUrl = $useSandbox
-            ? 'https://sandbox.payware.eu/api'
-            : 'https://api.payware.eu/api';
-        $this->partnerId = $partnerId ?: getenv('PAYWARE_PARTNER_ID');
-        $this->privateKey = $privateKey ?: $this->loadPrivateKey();
-    }
-
-    ${includeComments ? '/**' : '/*'}
-     ${includeComments ? ' * ' : ''}${opDef.description}
-     ${needsId ? ` * @param string $resourceId Resource identifier` : ''}
-     * @return array|null API response or null on error
-     ${includeComments ? ' */' : '*/'}
-    public function ${operation.replace('-', '_')}(${needsId ? '$resourceId' : ''}${opDef.queryParams ? (needsId ? ', ' : '') + '$queryParams = []' : ''})
-    {
-        ${includeComments ? '// API Configuration' : ''}
-        $endpoint = '${opDef.endpoint}';
-        ${needsId ? `$endpoint = str_replace('{id}', $resourceId, $endpoint);` : ''}
-        $url = $this->baseUrl . $endpoint;
-
-        ${opDef.queryParams ? `${includeComments ? '// Default query parameters' : ''}
-        $defaultParams = ${this.generatePHPArray(opDef.queryParams, '        ')};
-        $queryParams = array_merge($defaultParams, $queryParams ?? []);
-
-        if (!empty($queryParams)) {
-            $url .= '?' . http_build_query($queryParams);
-        }` : ''}
-
-        ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
-        $payload = ${this.generatePHPArray(opDef.sampleBody, '        ')};
-
-        ${includeComments ? '// CRITICAL: Use deterministic JSON serialization for both SHA-256 and HTTP body' : ''}
-        ${includeComments ? '// This prevents ERR_INVALID_CONTENT_HASH authentication errors' : ''}
-        ${includeComments ? '// Note: Implement createDeterministicJSON() function with ksort()' : ''}
-        ksort($payload);
-        $requestBody = json_encode($payload, JSON_UNESCAPED_SLASHES);` : `${includeComments ? '// No request body required' : ''}`}
-
-        ${includeComments ? '// Create JWT token for authentication' : ''}
-        $token = $this->createJWTToken(${opDef.sampleBody ? '$requestBody' : 'null'});
-
-        ${includeComments ? '// Prepare headers' : ''}
-        $headers = [
-            'Authorization: Bearer ' . $token,
-            'Content-Type: application/json',
-            'Api-Version: 1'
-        ];
-
-        ${includeErrorHandling ? 'try {' : ''}
-            ${includeComments ? '// Initialize cURL' : ''}
-            $ch = curl_init();
-
-            ${includeComments ? '// Set cURL options' : ''}
-            curl_setopt_array($ch, [
-                CURLOPT_URL => $url,
-                CURLOPT_RETURNTRANSFER => true,
-                CURLOPT_TIMEOUT => 30,
-                CURLOPT_CUSTOMREQUEST => '${opDef.method}',
-                CURLOPT_HTTPHEADER => $headers,
-                CURLOPT_SSL_VERIFYPEER => true,
-                CURLOPT_SSL_VERIFYHOST => 2
-            ]);
-
-            ${opDef.sampleBody ? `${includeComments ? '// CRITICAL: Send same requestBody used for JWT contentSha256' : ''}
-            curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);` : ''}
-
-            ${includeComments ? '// Execute request' : ''}
-            $response = curl_exec($ch);
-            $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
-            $error = curl_error($ch);
-            curl_close($ch);
-
-            ${includeErrorHandling ? `if ($error) {
-                throw new Exception("cURL Error: " . $error);
-            }
-
-            if ($httpCode >= 200 && $httpCode < 300) {
-                $result = json_decode($response, true);
-                echo "✅ ${opDef.description} successful\\n";
-                echo "Response: " . json_encode($result, JSON_PRETTY_PRINT) . "\\n";
-                ${this.getResultProcessingExample(operation, 'php', includeComments)}
-                return $result;
-            } else {
-                echo "❌ Request failed with HTTP {$httpCode}\\n";
-                echo "Response: " . $response . "\\n";
-                return null;
-            }
-
-        } catch (Exception $e) {
-            echo "❌ Error: " . $e->getMessage() . "\\n";
-            return null;
-        }` : `if ($error) {
-                echo "❌ cURL Error: " . $error . "\\n";
-                return null;
-            }
-
-            $result = json_decode($response, true);
-            ${includeComments ? `echo "✅ ${opDef.description} completed\\n";` : ''}
-            ${this.getResultProcessingExample(operation, 'php', includeComments)}
-            return $result;`}
-    }
-
-    /**
-     * Create JWT token for payware API authentication
-     * @param string|null $requestBody Request body for content SHA-256
-     * @return string JWT token
-     */
-    private function createJWTToken($requestBody = null)
-    {
-        ${includeComments ? '/**' : '/*'}
-         ${includeComments ? ' * CRITICAL: requestBody must be the exact same string' : ''}
-         ${includeComments ? ' * that will be sent in the HTTP request body to ensure' : ''}
-         ${includeComments ? ' * SHA-256 hash consistency and prevent ERR_INVALID_CONTENT_HASH errors.' : ''}
-         ${includeComments ? ' */' : '*/'}
-
-        ${includeComments ? '// JWT header' : ''}
-        $header = ['alg' => 'RS256', 'typ' => 'JWT'];
-
-        ${includeComments ? '// Add contentSha256 to header if request body exists' : ''}
-        if ($requestBody !== null) {
-            ${includeComments ? '// CRITICAL: Calculate SHA-256 from exact same string sent in HTTP request' : ''}
-            $header['contentSha256'] = base64_encode(hash('sha256', $requestBody, true));
-        }
-
-        ${includeComments ? '// JWT payload' : ''}
-        $payload = [
-            'iss' => $this->partnerId,
-            'aud' => 'https://payware.eu', ${includeComments ? '// CRITICAL: Must be https://payware.eu' : ''}
-            'iat' => time()
-        ];
-
-        ${includeComments ? '// Create and return JWT token' : ''}
-        return JWT::encode($payload, $this->privateKey, 'RS256', null, $header);
-    }
-
-    /**
-     * Load private key from file or environment
-     * @return string Private key content
-     */
-    private function loadPrivateKey()
-    {
-        ${includeComments ? '// Try to load from environment variable first' : ''}
-        $privateKey = getenv('PAYWARE_PRIVATE_KEY');
-
-        if ($privateKey) {
-            return $privateKey;
-        }
-
-        ${includeComments ? '// Try to load from file' : ''}
-        $keyFile = getenv('PAYWARE_PRIVATE_KEY_FILE') ?: 'keys/private-key.pem';
-
-        if (file_exists($keyFile)) {
-            return file_get_contents($keyFile);
-        }
-
-        throw new Exception('Private key not found. Set PAYWARE_PRIVATE_KEY or PAYWARE_PRIVATE_KEY_FILE environment variable.');
-    }
-}
-
-${includeComments ? '// Example usage' : ''}
-if (basename(__FILE__) === basename($_SERVER['PHP_SELF'])) {
-    ${includeErrorHandling ? 'try {' : ''}
-        ${includeComments ? '// Initialize client' : ''}
-        $client = new PaywareClient();
-
-        ${includeComments ? '// Execute operation' : ''}
-        $result = $client->${operation.replace('-', '_')}(${needsId ? "'example_123'" : ''}${opDef.queryParams ? (needsId ? ', []' : '[\'type\' => \'QR_CODE\']') : ''});
-
-        if ($result) {
-            echo "Operation completed successfully\\n";
-        } else {
-            echo "Operation failed\\n";
-            exit(1);
-        }
-
-    ${includeErrorHandling ? `} catch (Exception $e) {
-        echo "❌ Fatal error: " . $e->getMessage() . "\\n";
-        exit(1);
-    }` : ''}
-}
-
-?>`;
-
-    return this.wrapCodeExample(code, opDef.description, 'php', partnerType, options);
-  }
-
-  generateJavaExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-    const className = this.toPascalCase(operation);
-
-    const code = `${includeComments ? `// ${opDef.description} - Java Implementation` : ''}
-import java.net.http.HttpClient;
-import java.net.http.HttpRequest;
-import java.net.http.HttpResponse;
-import java.net.URI;
-import java.util.Map;
-import java.util.HashMap;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import java.time.Duration;
-
-public class ${className}Example {
-
-    private static final String BASE_URL = System.getenv("PAYWARE_BASE_URL") != null
-        ? System.getenv("PAYWARE_BASE_URL")
-        : "https://sandbox.payware.eu/api";
-
-    private static final ObjectMapper objectMapper = new ObjectMapper();
-
-    public static void main(String[] args) {
-        ${includeComments ? `/**
-         * ${opDef.description}
-         */` : ''}
-
-        ${includeErrorHandling ? 'try {' : ''}
-            ${needsId ? 'String resourceId = "example_123";' : ''}
-
-            ${includeComments ? '// API Configuration' : ''}
-            String endpoint = "${opDef.endpoint}"${needsId ? '.replace("{id}", resourceId)' : ''};
-            String url = BASE_URL + endpoint;
-
-            ${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
-            Map<String, String> queryParams = new HashMap<>();
-            ${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
-              `queryParams.put("${key}", "${value}");`
-            ).join('\n            ')}
-
-            StringBuilder queryString = new StringBuilder();
-            queryParams.forEach((key, value) -> {
-                if (queryString.length() > 0) queryString.append("&");
-                queryString.append(key).append("=").append(value);
-            });
-            if (queryString.length() > 0) {
-                url += "?" + queryString.toString();
-            }` : ''}
-
-            ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
-            Map<String, Object> payload = new HashMap<>();
-            ${this.generateJavaPayloadMapping(opDef.sampleBody, '            ', includeComments)}
-            String requestBody = objectMapper.writeValueAsString(payload);` : `${includeComments ? '// No request body required' : ''}`}
-
-            ${includeComments ? '// Authentication' : ''}
-            String token = createJWTToken(${opDef.sampleBody ? 'requestBody' : 'null'});
-
-            ${includeComments ? '// Build HTTP request' : ''}
-            HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
-                .uri(URI.create(url))
-                .header("Authorization", "Bearer " + token)
-                .header("Content-Type", "application/json")
-                .header("Api-Version", "1")
-                .timeout(Duration.ofSeconds(30));
-
-            ${opDef.method === 'POST' ? `requestBuilder.POST(HttpRequest.BodyPublishers.ofString(${opDef.sampleBody ? 'requestBody' : '""'}));` : ''}
-            ${opDef.method === 'GET' ? 'requestBuilder.GET();' : ''}
-            ${opDef.method === 'PUT' ? `requestBuilder.PUT(HttpRequest.BodyPublishers.ofString(${opDef.sampleBody ? 'requestBody' : '""'}));` : ''}
-            ${opDef.method === 'DELETE' ? 'requestBuilder.DELETE();' : ''}
-            ${opDef.method === 'PATCH' ? `requestBuilder.method("PATCH", HttpRequest.BodyPublishers.ofString(${opDef.sampleBody ? 'requestBody' : '""'}));` : ''}
-
-            HttpRequest request = requestBuilder.build();
-
-            ${includeComments ? '// Execute request' : ''}
-            HttpClient client = HttpClient.newHttpClient();
-            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
-
-            ${includeComments ? '// Process response' : ''}
-            System.out.println("✅ " + "${opDef.description}" + " successful");
-            System.out.println("Status: " + response.statusCode());
-            System.out.println("Response: " + response.body());
-
-            ${this.getResultProcessingExample(operation, 'java', includeComments)}
-
-        ${includeErrorHandling ? `} catch (Exception e) {
-            System.err.println("❌ Request failed: " + e.getMessage());
-            e.printStackTrace();
-        }` : ''}
-    }
-
-    private static String createJWTToken(String requestBody) {
-        /**
-         * Create JWT token for payware API authentication
-         * Implementation depends on your JWT library setup
-         * See authentication examples for complete implementation
-         */
-        return "your-jwt-token";
-    }
-
-    ${this.generateJavaUtilityMethods()}
-}`;
-
-    return this.wrapCodeExample(code, opDef.description, 'java', partnerType, options);
-  }
-
-  generateCSharpExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-    const className = this.toPascalCase(operation);
-
-    const code = `${includeComments ? `// ${opDef.description} - C# Implementation` : ''}
-using System;
-using System.Net.Http;
-using System.Text;
-using System.Text.Json;
-using System.Threading.Tasks;
-using System.Collections.Generic;
-
-namespace PaywareIntegration
-{
-    public class ${className}Example
-    {
-        private static readonly HttpClient httpClient = new HttpClient();
-        private static readonly string BaseUrl = Environment.GetEnvironmentVariable("PAYWARE_BASE_URL") ?? "https://sandbox.payware.eu/api";
-
-        public static async Task Main(string[] args)
-        {
-            ${includeComments ? `/**
-             * ${opDef.description}
-             */` : ''}
-
-            ${includeErrorHandling ? 'try {' : ''}
-                ${needsId ? 'string resourceId = "example_123";' : ''}
-
-                ${includeComments ? '// API Configuration' : ''}
-                string endpoint = "${opDef.endpoint}"${needsId ? '.Replace("{id}", resourceId)' : ''};
-                string url = $"{BaseUrl}{endpoint}";
-
-                ${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
-                var queryParams = new Dictionary<string, string>
-                {
-                    ${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
-                      `["${key}"] = "${value}"`
-                    ).join(',\n                    ')}
-                };
-
-                if (queryParams.Count > 0)
-                {
-                    var queryString = string.Join("&", queryParams.Select(kv => $"{kv.Key}={kv.Value}"));
-                    url += $"?{queryString}";
-                }` : ''}
-
-                ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
-                var payload = new
-                {
-                    ${this.generateCSharpPayload(opDef.sampleBody)}
-                };
-                string requestBody = JsonSerializer.Serialize(payload);` : `${includeComments ? '// No request body required' : ''}`}
-
-                ${includeComments ? '// Authentication' : ''}
-                string token = CreateJWTToken(${opDef.sampleBody ? 'requestBody' : 'null'});
-
-                ${includeComments ? '// Configure HTTP request' : ''}
-                var request = new HttpRequestMessage(HttpMethod.${this.toCSharpHttpMethod(opDef.method)}, url);
-                request.Headers.Add("Authorization", $"Bearer {token}");
-                request.Headers.Add("Api-Version", "1");
-
-                ${opDef.sampleBody ? 'request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");' : ''}
-
-                ${includeComments ? '// Execute request' : ''}
-                HttpResponseMessage response = await httpClient.SendAsync(request);
-                string responseContent = await response.Content.ReadAsStringAsync();
-
-                ${includeComments ? '// Process response' : ''}
-                Console.WriteLine($"✅ ${opDef.description} successful");
-                Console.WriteLine($"Status: {response.StatusCode}");
-                Console.WriteLine($"Response: {responseContent}");
-
-                ${this.getResultProcessingExample(operation, 'csharp', includeComments)}
-
-            ${includeErrorHandling ? `} catch (Exception ex) {
-                Console.WriteLine($"❌ Request failed: {ex.Message}");
-            }` : ''}
-        }
-
-        private static string CreateJWTToken(string requestBody)
-        {
-            /**
-             * Create JWT token for payware API authentication
-             * Implementation depends on your JWT library setup
-             * See authentication examples for complete implementation
-             */
-            return "your-jwt-token";
-        }
-    }
-}`;
-
-    return this.wrapCodeExample(code, opDef.description, 'csharp', partnerType, options);
-  }
-
-  generateGoExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-    const functionName = this.toCamelCase(operation);
-
-    const code = `${includeComments ? `// ${opDef.description} - Go Implementation` : ''}
-package main
-
-import (
-	"bytes"
-	"encoding/json"
-	"fmt"
-	"io"
-	"net/http"
-	"net/url"
-	"os"
-	"strings"
-	"time"
-)
-
-${opDef.sampleBody ? `${includeComments ? `// ${this.toPascalCase(operation)}Request represents the request payload` : ''}
-type ${this.toPascalCase(operation)}Request struct {
-	${this.generateGoStructFields(opDef.sampleBody)}
-}
-
-${includeComments ? `// ${this.toPascalCase(operation)}Response represents the API response` : ''}
-type ${this.toPascalCase(operation)}Response struct {
-	Status string \`json:"status"\`
-	Data   interface{} \`json:"data"\`
-	Error  string \`json:"error,omitempty"\`
-}` : ''}
-
-func main() {
-	${includeComments ? `/**
-	 * ${opDef.description}
-	 */` : ''}
-
-	${includeErrorHandling ? 'if err := ' : ''}${functionName}Example()${includeErrorHandling ? '; err != nil {' : ''}
-	${includeErrorHandling ? `	fmt.Printf("❌ Error: %v\\n", err)
-		os.Exit(1)
-	}` : ''}
-}
-
-func ${functionName}Example() error {
-	${includeComments ? '// Configuration' : ''}
-	baseURL := os.Getenv("PAYWARE_BASE_URL")
-	if baseURL == "" {
-		baseURL = "https://sandbox.payware.eu/api"
-	}
-
-	${needsId ? 'resourceID := "example_123"' : ''}
-
-	${includeComments ? '// API Configuration' : ''}
-	endpoint := "${opDef.endpoint}"
-	${needsId ? 'endpoint = strings.Replace(endpoint, "{id}", resourceID, 1)' : ''}
-	fullURL := baseURL + endpoint
-
-	${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
-	params := url.Values{}
-	${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
-		`params.Add("${key}", "${value}")`
-	).join('\n\t')}
-
-	if len(params) > 0 {
-		fullURL += "?" + params.Encode()
-	}` : ''}
-
-	${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
-	payload := ${this.toPascalCase(operation)}Request{
-		${this.generateGoPayloadValues(opDef.sampleBody)}
-	}
-
-	requestBody, err := json.Marshal(payload)
-	if err != nil {
-		return fmt.Errorf("failed to marshal request: %w", err)
-	}` : `${includeComments ? '// No request body required' : ''}`}
-
-	${includeComments ? '// Authentication' : ''}
-	token := createJWTToken(${opDef.sampleBody ? 'string(requestBody)' : '""'})
-
-	${includeComments ? '// Create HTTP request' : ''}
-	${opDef.sampleBody ? 'req, err := http.NewRequest("' + opDef.method + '", fullURL, bytes.NewBuffer(requestBody))' : 'req, err := http.NewRequest("' + opDef.method + '", fullURL, nil)'}
-	if err != nil {
-		return fmt.Errorf("failed to create request: %w", err)
-	}
-
-	// Set headers
-	req.Header.Set("Authorization", "Bearer "+token)
-	req.Header.Set("Content-Type", "application/json")
-	req.Header.Set("Api-Version", "1")
-
-	${includeComments ? '// Execute request' : ''}
-	client := &http.Client{
-		Timeout: 30 * time.Second,
-	}
-
-	resp, err := client.Do(req)
-	if err != nil {
-		return fmt.Errorf("request failed: %w", err)
-	}
-	defer resp.Body.Close()
-
-	// Read response
-	responseBody, err := io.ReadAll(resp.Body)
-	if err != nil {
-		return fmt.Errorf("failed to read response: %w", err)
-	}
-
-	${includeComments ? '// Process response' : ''}
-	fmt.Printf("✅ %s successful\\n", "${opDef.description}")
-	fmt.Printf("Status: %s\\n", resp.Status)
-	fmt.Printf("Response: %s\\n", string(responseBody))
-
-	${this.getResultProcessingExample(operation, 'go', includeComments)}
-
-	return nil
-}
-
-func createJWTToken(requestBody string) string {
-	/**
-	 * Create JWT token for payware API authentication
-	 * Implementation depends on your JWT library setup
-	 * See authentication examples for complete implementation
-	 */
-	return "your-jwt-token"
-}`;
-
-    return this.wrapCodeExample(code, opDef.description, 'go', partnerType, options);
-  }
-
-  generateRubyExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-    const methodName = this.toSnakeCase(operation);
-
-    const code = `${includeComments ? `# ${opDef.description} - Ruby Implementation` : ''}
-require 'net/http'
-require 'uri'
-require 'json'
-require 'openssl'
-require 'base64'
-
-class PaywareClient
-  def initialize
-    @base_url = ENV['PAYWARE_BASE_URL'] || 'https://sandbox.payware.eu/api'
-  end
-
-  def ${methodName}_example(${needsId ? "resource_id = 'example_123'" : ''})
-    ${includeComments ? `# ${opDef.description}` : ''}
-
-    ${includeErrorHandling ? 'begin' : ''}
-      ${includeComments ? '# API Configuration' : ''}
-      endpoint = '${opDef.endpoint}'
-      ${needsId ? "endpoint = endpoint.gsub('{id}', resource_id)" : ''}
-      uri = URI("#{@base_url}#{endpoint}")
-
-      ${opDef.queryParams ? `${includeComments ? '# Query parameters' : ''}
-      query_params = {
-        ${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
-          `'${key}' => '${value}'`
-        ).join(',\n        ')}
-      }
-
-      uri.query = URI.encode_www_form(query_params) unless query_params.empty?` : ''}
-
-      ${opDef.sampleBody ? `${includeComments ? '# Request payload' : ''}
-      payload = {
-        ${this.generateRubyPayload(opDef.sampleBody)}
-      }
-      request_body = payload.to_json` : '# No request body required'}
-
-      # Authentication
-      token = create_jwt_token(${opDef.sampleBody ? 'request_body' : 'nil'})
-
-      # Create HTTP request
-      http = Net::HTTP.new(uri.host, uri.port)
-      http.use_ssl = true if uri.scheme == 'https'
-      http.open_timeout = 30
-      http.read_timeout = 30
-
-      request = Net::HTTP::${this.toRubyHttpMethod(opDef.method)}.new(uri)
-      request['Authorization'] = "Bearer #{token}"
-      request['Content-Type'] = 'application/json'
-      request['Api-Version'] = '1'
-
-      ${opDef.sampleBody ? 'request.body = request_body' : ''}
-
-      # Execute request
-      response = http.request(request)
-
-      # Process response
-      puts "✅ ${opDef.description} successful"
-      puts "Status: #{response.code} #{response.message}"
-      puts "Response: #{response.body}"
-
-      ${this.getResultProcessingExample(operation, 'ruby', includeComments)}
-
-      # Parse JSON response if needed
-      if response.content_type&.include?('application/json')
-        result = JSON.parse(response.body)
-        return result
-      end
-
-      response.body
-
-    ${includeErrorHandling ? `rescue StandardError => e
-      puts "❌ Request failed: #{e.message}"
-      raise e
-    end` : ''}
-  end
-
-  private
-
-  def create_jwt_token(request_body = nil)
-    # Create JWT token for payware API authentication
-    # Implementation depends on your JWT library setup
-    ${includeComments ? '# See authentication examples for complete implementation' : ''}
-    'your-jwt-token'
-  end
-end
-
-${includeComments ? '# Example usage' : ''}
-if __FILE__ == $0
-  client = PaywareClient.new
-  ${includeErrorHandling ? 'begin' : ''}
-    result = client.${methodName}_example${needsId ? "('example_123')" : '()'}
-    puts "Operation completed successfully"
-  ${includeErrorHandling ? `rescue StandardError => e
-    puts "Error: #{e.message}"
-    exit 1
-  end` : ''}
-end`;
-
-    return this.wrapCodeExample(code, opDef.description, 'ruby', partnerType, options);
-  }
-
-  generateCurlExample(operation, opDef, partnerType, options) {
-    const { includeComments, includeErrorHandling } = options;
-    const needsId = opDef.endpoint.includes('{id}');
-
-    const code = `#!/bin/bash
-${includeComments ? `# ${opDef.description} - cURL Implementation` : ''}
-
-${includeComments ? '# Configuration' : ''}
-BASE_URL="\${PAYWARE_BASE_URL:-https://sandbox.payware.eu/api}"
-${needsId ? 'RESOURCE_ID="example_123"' : ''}
-
-${includeComments ? '# API Configuration' : ''}
-ENDPOINT="${opDef.endpoint}"${needsId ? `
-ENDPOINT="\${ENDPOINT//\\{id\\}/\$RESOURCE_ID}"` : ''}
-URL="$BASE_URL$ENDPOINT"
-
-${opDef.queryParams ? `${includeComments ? '# Query parameters' : ''}
-QUERY_PARAMS="${Object.entries(opDef.queryParams || {}).map(([key, value]) => `${key}=${value}`).join('&')}"
-URL="$URL?$QUERY_PARAMS"` : ''}
-
-${opDef.sampleBody ? `${includeComments ? '# Request payload' : ''}
-read -r -d '' REQUEST_BODY << 'EOF'
-${JSON.stringify(opDef.sampleBody, null, 2)}
-EOF` : '# No request body required'}
-
-# Authentication (placeholder - implement JWT token creation)
-JWT_TOKEN="your-jwt-token"
-
-# Content-SHA256 for payware API (if request body exists)
-${opDef.sampleBody ? `CONTENT_SHA256=$(echo -n "$REQUEST_BODY" | openssl dgst -sha256 -binary | base64)` : ''}
-
-echo "🚀 Executing ${opDef.description}..."
-echo "URL: $URL"
-
-${includeErrorHandling ? '# Execute with error handling' : '# Execute request'}
-${opDef.sampleBody ? `
-curl -X ${opDef.method} "$URL" \\
-  -H "Authorization: Bearer $JWT_TOKEN" \\
-  -H "Content-Type: application/json" \\
-  -H "Api-Version: 1" \\
-  ${opDef.sampleBody ? '-H "Content-SHA256: $CONTENT_SHA256" \\' : ''}
-  ${includeErrorHandling ? '-f -s -S \\' : '-v \\'}
-  ${opDef.sampleBody ? '-d "$REQUEST_BODY"' : ''}` : `
-curl -X ${opDef.method} "$URL" \\
-  -H "Authorization: Bearer $JWT_TOKEN" \\
-  -H "Content-Type: application/json" \\
-  -H "Api-Version: 1" \\
-  ${includeErrorHandling ? '-f -s -S' : '-v'}`}
-
-${includeErrorHandling ? `
-# Check exit status
-if [ $? -eq 0 ]; then
-    echo "✅ ${opDef.description} successful"
-else
-    echo "❌ Request failed"
-    exit 1
-fi` : ''}
-
-echo "✅ Request completed"`;
-
-    return this.wrapCodeExample(code, opDef.description, 'bash', partnerType, options);
-  }
-
-
-  generateBasicAuthExample(language, partnerType, options) {
-    const { includeComments = true } = options;
-
-    const authExamples = {
-      python: `${includeComments ? '# Basic Authentication Setup - Python' : ''}
-import jwt
-import json
-import hashlib
-import base64
-from datetime import datetime, timezone
-
-def create_jwt_token(request_body=None):
-    ${includeComments ? '"""Create JWT token for payware API authentication"""' : ''}
-    partner_id = "YOUR_PARTNER_ID"
-    private_key = """-----BEGIN RSA PRIVATE KEY-----
-YOUR_PRIVATE_KEY_HERE
------END RSA PRIVATE KEY-----"""
-
-    # Create content SHA-256 for request body
-    content_sha256 = ""
-    if request_body:
-        content_sha256 = base64.b64encode(hashlib.sha256(request_body.encode()).digest()).decode()
-
-    # JWT payload
-    payload = {
-        "iss": partner_id,
-        "aud": "payware.eu",
-        "iat": int(datetime.now(timezone.utc).timestamp()),
-        "exp": int(datetime.now(timezone.utc).timestamp()) + 300,
-        "contentSha256": content_sha256
-    }
-
-    # Create JWT token
-    token = jwt.encode(payload, private_key, algorithm="RS256")
-    return token
-
-${includeComments ? '# Example usage' : ''}
-token = create_jwt_token()
-print(f"JWT Token: {token}")`,
-
-      nodejs: `${includeComments ? '// Basic Authentication Setup - Node.js' : ''}
-const jwt = require('jsonwebtoken');
-const crypto = require('crypto');
-
-function createJWTToken(requestBody = null) {
-    /**
-     * Create JWT token for payware API authentication
-     */
-    const partnerId = "YOUR_PARTNER_ID";
-    const privateKey = \`-----BEGIN RSA PRIVATE KEY-----
-YOUR_PRIVATE_KEY_HERE
------END RSA PRIVATE KEY-----\`;
-
-    ${includeComments ? '// Create content SHA-256' : ''} for request body
-    let contentSha256 = "";
-    if (requestBody) {
-        contentSha256 = crypto.createHash('sha256').update(requestBody).digest('base64');
-    }
-
-    // JWT payload
-    const payload = {
-        iss: partnerId,
-        aud: "payware.eu",
-        iat: Math.floor(Date.now() / 1000),
-        exp: Math.floor(Date.now() / 1000) + 300,
-        contentSha256: contentSha256
-    };
-
-    // Create JWT token
-    const token = jwt.sign(payload, privateKey, { algorithm: 'RS256' });
-    return token;
-}
-
-${includeComments ? '// Example usage' : ''}
-const token = createJWTToken();
-console.log(\`JWT Token: \${token}\`);`,
-
-      java: `${includeComments ? '// Basic Authentication Setup - Java' : ''}
-import io.jsonwebtoken.Jwts;
-import io.jsonwebtoken.SignatureAlgorithm;
-import java.security.PrivateKey;
-import java.security.spec.PKCS8EncodedKeySpec;
-import java.security.KeyFactory;
-import java.util.Date;
-import java.util.Map;
-import java.util.HashMap;
-import java.security.MessageDigest;
-import java.util.Base64;
-
-public class PaywareAuth {
-
-    private static String createJWTToken(String requestBody) {
-        try {
-            String partnerId = "YOUR_PARTNER_ID";
-            String privateKeyPEM = "-----BEGIN RSA PRIVATE KEY-----\\nYOUR_PRIVATE_KEY_HERE\\n-----END RSA PRIVATE KEY-----";
-
-            ${includeComments ? '// Create content SHA-256' : ''}
-            String contentSha256 = "";
-            if (requestBody != null) {
-                MessageDigest md = MessageDigest.getInstance("SHA-256");
-                byte[] digest = md.digest(requestBody.getBytes());
-                contentSha256 = Base64.getEncoder().encodeToString(digest);
-            }
-
-            // JWT payload
-            Map<String, Object> claims = new HashMap<>();
-            claims.put("iss", partnerId);
-            claims.put("aud", "payware.eu");
-            claims.put("iat", new Date().getTime() / 1000);
-            claims.put("exp", (new Date().getTime() / 1000) + 300);
-            claims.put("contentSha256", contentSha256);
-
-            // Note: You'll need to implement private key loading
-            // PrivateKey privateKey = loadPrivateKey(privateKeyPEM);
-
-            return "your-jwt-token"; // Placeholder - implement JWT creation
-
-        } catch (Exception e) {
-            throw new RuntimeException("Failed to create JWT token", e);
-        }
-    }
-
-    public static void main(String[] args) {
-        String token = createJWTToken(null);
-        System.out.println("JWT Token: " + token);
-    }
-}`,
-
-      csharp: `${includeComments ? '// Basic Authentication Setup - C#' : ''}
-using System;
-using System.Text;
-using System.Security.Cryptography;
-using Microsoft.IdentityModel.Tokens;
-using System.IdentityModel.Tokens.Jwt;
-using System.Security.Claims;
-
-public class PaywareAuth
-{
-    private static string CreateJWTToken(string requestBody = null)
-    {
-        var partnerId = "YOUR_PARTNER_ID";
-        var privateKeyPEM = @"-----BEGIN RSA PRIVATE KEY-----
-YOUR_PRIVATE_KEY_HERE
------END RSA PRIVATE KEY-----";
-
-        ${includeComments ? '// Create content SHA-256' : ''}
-        var contentSha256 = "";
-        if (!string.IsNullOrEmpty(requestBody))
-        {
-            using (var sha256 = SHA256.Create())
-            {
-                var hash = sha256.ComputeHash(Encoding.UTF8.GetBytes(requestBody));
-                contentSha256 = Convert.ToBase64String(hash);
-            }
-        }
-
-        // JWT payload
-        var claims = new[]
-        {
-            new Claim("iss", partnerId),
-            new Claim("aud", "payware.eu"),
-            new Claim("iat", DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(), ClaimValueTypes.Integer),
-            new Claim("exp", DateTimeOffset.UtcNow.AddMinutes(5).ToUnixTimeSeconds().ToString(), ClaimValueTypes.Integer),
-            new Claim("contentSha256", contentSha256)
-        };
-
-        // Note: You'll need to implement RSA key loading
-        // var rsa = RSA.Create();
-        // rsa.ImportFromPem(privateKeyPEM);
-        // var key = new RsaSecurityKey(rsa);
-
-        return "your-jwt-token"; // Placeholder - implement JWT creation
-    }
-
-    public static void Main(string[] args)
-    {
-        var token = CreateJWTToken();
-        Console.WriteLine($"JWT Token: {token}");
-    }
-}`,
-
-      php: `${includeComments ? '<?php // Basic Authentication Setup - PHP' : '<?php'}
-require_once 'vendor/autoload.php';
-use Firebase\\JWT\\JWT;
-use Firebase\\JWT\\Key;
-
-function createJWTToken($requestBody = null) {
-    $partnerId = "YOUR_PARTNER_ID";
-    $privateKey = "-----BEGIN RSA PRIVATE KEY-----
-YOUR_PRIVATE_KEY_HERE
------END RSA PRIVATE KEY-----";
-
-    ${includeComments ? '// Create content SHA-256' : ''}
-    $contentSha256 = "";
-    if ($requestBody !== null) {
-        $contentSha256 = base64_encode(hash('sha256', $requestBody, true));
-    }
-
-    // JWT payload
-    $payload = [
-        'iss' => $partnerId,
-        'aud' => 'payware.eu',
-        'iat' => time(),
-        'exp' => time() + 300,
-        'contentSha256' => $contentSha256
-    ];
-
-    // Create JWT token
-    $token = JWT::encode($payload, $privateKey, 'RS256');
-    return $token;
-}
-
-${includeComments ? '// Example usage' : ''}
-$token = createJWTToken();
-echo "JWT Token: " . $token . "\\n";
-?>`,
-
-      curl: `${includeComments ? '#!/bin/bash\n# Basic Authentication Setup - cURL' : '#!/bin/bash'}
-
-# Configuration
-PARTNER_ID="YOUR_PARTNER_ID"
-PRIVATE_KEY_FILE="path/to/private-key.pem"
-
-# Function to create JWT token (simplified)
-create_jwt_token() {
-    local request_body="\$1"
-    local content_sha256=""
-
-    if [ -n "\$request_body" ]; then
-        content_sha256=\$(echo -n "\$request_body" | openssl dgst -sha256 -binary | base64)
-    fi
-
-    echo "your-jwt-token" # Placeholder - implement JWT creation with openssl
-}
-
-${includeComments ? '# Example usage' : ''}
-JWT_TOKEN=\$(create_jwt_token)
-echo "JWT Token: \$JWT_TOKEN"`
-    };
-
-    return this.wrapCodeExample(
-      authExamples[language] || authExamples.python,
-      'Authentication Setup',
-      language,
-      partnerType,
-      options
-    );
-  }
-
-  // Helper methods for Java code generation
-  toPascalCase(str) {
-    return str.split(/[-_]/).map(word =>
-      word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
-    ).join('');
-  }
-
-  generateJavaPayloadMapping(payload, indent = '            ', includeComments = true) {
-    if (!payload) return '';
-
-    const generateMapping = (obj, path = '') => {
-      let result = [];
-      for (const [key, value] of Object.entries(obj)) {
-        const currentPath = path ? `${path}.${key}` : key;
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-          result.push(`${indent}Map<String, Object> ${key} = new HashMap<>();`);
-          result.push(...generateMapping(value, key).map(line => line.replace(/^            /, indent)));
-          result.push(`${indent}payload.put("${key}", ${key});`);
-        } else if (Array.isArray(value)) {
-          if (includeComments) {
-            result.push(`${indent}// Note: Array handling needed for ${key}`);
-          }
-          result.push(`${indent}payload.put("${key}", Arrays.asList(${JSON.stringify(value)}));`);
-        } else {
-          const javaValue = typeof value === 'string' ? `"${value}"` : value;
-          if (path) {
-            result.push(`${indent}${path}.put("${key}", ${javaValue});`);
-          } else {
-            result.push(`${indent}payload.put("${key}", ${javaValue});`);
-          }
-        }
-      }
-      return result;
-    };
-
-    return generateMapping(payload).join('\n');
-  }
-
-  generateJavaUtilityMethods() {
-    return `
-    // Utility methods for handling responses and common operations
-    // Add additional helper methods as needed for your specific implementation`;
-  }
-
-  getResultProcessingExample(operation, language) {
-    const examples = {
-      create_transaction: {
-        java: 'System.out.println("Transaction ID: " + response.body());',
-        nodejs: 'console.log("Transaction ID:", result.transactionId);',
-        python: 'print(f"Transaction ID: {result[\'transactionId\']}")',
-        csharp: 'Console.WriteLine($"Transaction ID: {responseContent}");',
-        go: 'fmt.Printf("Transaction ID: %s\\n", responseBody)',
-        ruby: 'puts "Transaction ID: #{response.body}"',
-        php: 'echo "Transaction ID: " . $result[\'transactionId\'] . "\\n";'
-      },
-      get_transaction_link: {
-        java: 'System.out.println("Deep link URL: " + response.body());',
-        nodejs: 'console.log("Deep link URL:", result.deepLinkUrl);',
-        python: 'print(f"Deep link URL: {result[\'deepLinkUrl\']}")',
-        csharp: 'Console.WriteLine($"Deep link URL: {responseContent}");',
-        go: 'fmt.Printf("Deep link URL: %s\\n", responseBody)',
-        ruby: 'puts "Deep link URL: #{result[\'deepLinkUrl\']}"',
-        php: 'echo "Deep link URL: " . $result[\'deepLinkUrl\'] . "\\n";'
-      }
-    };
-
-    return examples[operation]?.[language] || '// Process result as needed';
-  }
-
-  // C# helper methods
-  toCSharpHttpMethod(method) {
-    const methodMap = {
-      'GET': 'Get',
-      'POST': 'Post',
-      'PUT': 'Put',
-      'DELETE': 'Delete',
-      'PATCH': 'Patch'
-    };
-    return methodMap[method] || 'Post';
-  }
-
-  generateCSharpPayload(payload, indent = '                    ') {
-    if (!payload) return '';
-
-    const generateMapping = (obj, depth = 0) => {
-      let result = [];
-      for (const [key, value] of Object.entries(obj)) {
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-          result.push(`${key} = new {`);
-          result.push(...generateMapping(value, depth + 1).map(line => `    ${line}`));
-          result.push('}');
-        } else if (Array.isArray(value)) {
-          result.push(`${key} = new[] { ${value.map(v => typeof v === 'string' ? `"${v}"` : v).join(', ')} }`);
-        } else {
-          const csharpValue = typeof value === 'string' ? `"${value}"` : value;
-          result.push(`${key} = ${csharpValue}`);
-        }
-      }
-      return result;
-    };
-
-    return generateMapping(payload).join(',\n' + indent);
-  }
-
-  // Go helper methods
-  toCamelCase(str) {
-    return str.split(/[-_]/).map((word, index) =>
-      index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
-    ).join('');
-  }
-
-  generateGoStructFields(payload, indent = '\t') {
-    if (!payload) return '';
-
-    const generateFields = (obj, depth = 0) => {
-      let result = [];
-      for (const [key, value] of Object.entries(obj)) {
-        const fieldName = this.toPascalCase(key);
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-          result.push(`${fieldName} struct {`);
-          result.push(...generateFields(value, depth + 1).map(line => `\t${line}`));
-          result.push(`} \`json:"${key}"\``);
-        } else if (Array.isArray(value)) {
-          const elemType = value.length > 0 ? (typeof value[0] === 'string' ? 'string' : 'interface{}') : 'interface{}';
-          result.push(`${fieldName} []${elemType} \`json:"${key}"\``);
-        } else {
-          const goType = typeof value === 'string' ? 'string' : 'interface{}';
-          result.push(`${fieldName} ${goType} \`json:"${key}"\``);
-        }
-      }
-      return result;
-    };
-
-    return generateFields(payload).join('\n' + indent);
-  }
-
-  generateGoPayloadValues(payload, indent = '\t\t') {
-    if (!payload) return '';
-
-    const generateValues = (obj, depth = 0) => {
-      let result = [];
-      for (const [key, value] of Object.entries(obj)) {
-        const fieldName = this.toPascalCase(key);
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-          result.push(`${fieldName}: ${this.toPascalCase(key)}Request{`);
-          result.push(...generateValues(value, depth + 1).map(line => `\t${line}`));
-          result.push('},');
-        } else if (Array.isArray(value)) {
-          const arrayValues = value.map(v => typeof v === 'string' ? `"${v}"` : v).join(', ');
-          result.push(`${fieldName}: []interface{}{${arrayValues}},`);
-        } else {
-          const goValue = typeof value === 'string' ? `"${value}"` : value;
-          result.push(`${fieldName}: ${goValue},`);
-        }
-      }
-      return result;
-    };
-
-    return generateValues(payload).join('\n' + indent);
-  }
-
-  // Ruby helper methods
-  toSnakeCase(str) {
-    return str.split(/[-_]/).map(word => word.toLowerCase()).join('_');
-  }
-
-  toRubyHttpMethod(method) {
-    const methodMap = {
-      'GET': 'Get',
-      'POST': 'Post',
-      'PUT': 'Put',
-      'DELETE': 'Delete',
-      'PATCH': 'Patch'
-    };
-    return methodMap[method] || 'Post';
-  }
-
-  generateRubyPayload(payload, indent = '        ') {
-    if (!payload) return '';
-
-    const generateValues = (obj, depth = 0) => {
-      let result = [];
-      for (const [key, value] of Object.entries(obj)) {
-        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-          result.push(`'${key}' => {`);
-          result.push(...generateValues(value, depth + 1).map(line => `  ${line}`));
-          result.push('}');
-        } else if (Array.isArray(value)) {
-          const arrayValues = value.map(v => typeof v === 'string' ? `'${v}'` : v).join(', ');
-          result.push(`'${key}' => [${arrayValues}]`);
-        } else {
-          const rubyValue = typeof value === 'string' ? `'${value}'` : value;
-          result.push(`'${key}' => ${rubyValue}`);
-        }
-      }
-      return result;
-    };
-
-    return generateValues(payload).join(',\n' + indent);
-  }
-
-  // PHP helper methods
-  generatePHPArray(payload, baseIndent = '        ') {
-    if (!payload) return '[]';
-
-    const formatValue = (value, depth = 0) => {
-      const indent = baseIndent + '    '.repeat(depth);
-
-      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-        const entries = Object.entries(value).map(([k, v]) => {
-          return `${indent}    '${k}' => ${formatValue(v, depth + 1)}`;
-        });
-        return `[\n${entries.join(',\n')}\n${indent}]`;
-      } else if (Array.isArray(value)) {
-        const arrayValues = value.map(v => typeof v === 'string' ? `'${v}'` : v).join(', ');
-        return `[${arrayValues}]`;
-      } else {
-        return typeof value === 'string' ? `'${value}'` : value;
-      }
-    };
-
-    const entries = Object.entries(payload).map(([key, value]) => {
-      return `${baseIndent}    '${key}' => ${formatValue(value)}`;
-    });
-
-    return `[\n${entries.join(',\n')}\n${baseIndent}]`;
-  }
-
-  // Framework-specific generators (basic implementations)
-  generateDjangoExample(operation, partnerType, options) {
-    return `# Django Framework Implementation for ${operation}
-# views.py
-from django.http import JsonResponse
-from rest_framework.views import APIView
-
-class PaywareAPIView(APIView):
-    def post(self, request):
-        # Implementation for ${operation}
-        return JsonResponse({'status': 'success'})`;
-  }
-
-  generateExpressExample(operation, partnerType, options) {
-    return `// Express.js Framework Implementation for ${operation}
-const express = require('express');
-const router = express.Router();
-
-router.post('/${operation}', async (req, res) => {
-    // Implementation for ${operation}
-    res.json({ status: 'success' });
-});
-
-module.exports = router;`;
-  }
-
-  generateLaravelExample(operation, partnerType, options) {
-    return `<?php
-// Laravel Framework Implementation for ${operation}
-namespace App\\Http\\Controllers;
-
-use Illuminate\\Http\\Request;
-
-class PaywareController extends Controller
-{
-    public function ${operation}(Request $request)
-    {
-        // Implementation for ${operation}
-        return response()->json(['status' => 'success']);
-    }
-}
-?>`;
-  }
-}
-
-// Export the advanced generator
-export const advancedCodeGenerator = new AdvancedCodeGenerator();
-
-/**
- * Main code generation tool
- */
-export const generateCodeExampleTool = {
-  name: 'payware_generate_code_example',
-  description: 'Generate production-ready payware API integration code examples with authentication, error handling, and environment configuration for any operation across 16 supported operations and 6 programming languages.',
-
-  inputSchema: {
-    type: 'object',
-    properties: {
-      operation: {
-        type: 'string',
-        description: 'payware API operation to generate code for. Categories: AUTHENTICATION (authentication), TRANSACTIONS (create_transaction, get_transaction_status, process_transaction, cancel_transaction, get_transaction_history), PRODUCTS - merchant/ISV only (create_product, get_product, list_products, update_product, delete_product), OAUTH2 - ISV only (obtain_token, get_token_info), REPORTS (generate_report, get_report_status, export_report), DEEP LINKS (get_transaction_link, get_product_link), AUDIO/SOUNDBITES - merchant/ISV only (register_audio, get_audios, get_audio, update_audio, delete_audio)',
-        enum: [
-          'authentication',
-          'create_transaction',
-          'get_transaction_status',
-          'process_transaction',
-          'cancel_transaction',
-          'get_transaction_history',
-          'create_product',
-          'get_product',
-          'list_products',
-          'update_product',
-          'delete_product',
-          'obtain_token',
-          'get_token_info',
-          'generate_report',
-          'get_report_status',
-          'export_report',
-          'get_transaction_link',
-          'get_product_link',
-          'register_audio',
-          'get_audios',
-          'get_audio',
-          'update_audio',
-          'delete_audio'
-        ]
-      },
-      language: {
-        type: 'string',
-        description: 'Programming language for generated code examples. Options: python (requests, JWT), nodejs (axios, async/await), php (cURL, PSR standards), java (HTTP client, Jackson), csharp (HttpClient, System.Text.Json), curl (command-line). All include authentication, environment configuration, and error handling.',
-        enum: ['python', 'nodejs', 'php', 'java', 'csharp', 'curl']
-      },
-      partner_type: {
-        type: 'string',
-        description: 'payware partner type determines available operations. merchant: transactions, products, reports, deep links. isv: all merchant operations plus OAuth2 token management for multiple merchants. payment_institution: transactions, advanced settlement features.',
-        enum: ['merchant', 'isv', 'payment_institution']
-      },
-      include_comments: {
-        type: 'boolean',
-        description: 'Include detailed code comments and documentation in generated code. true (default): full documentation with inline comments, function docs, parameter explanations, usage examples. false: clean minimal code without comments for experienced developers.'
-      },
-      include_error_handling: {
-        type: 'boolean',
-        description: 'Include comprehensive error handling and validation in generated code. true (default): robust error handling with try/catch blocks, HTTP status validation, network error handling, detailed error messages. false: minimal error handling for streamlined code.'
-      }
-    },
-    required: ['operation'],
-    additionalProperties: false
-  },
-
-  async handler(args) {
-    try {
-      // Convert snake_case to camelCase for options
-      const options = {
-        includeComments: args.include_comments !== false, // Default true
-        includeErrorHandling: args.include_error_handling !== false, // Default true
-        framework: args.framework
-      };
-
-      const result = advancedCodeGenerator.generateExample(
-        args.operation,
-        args.language || 'python',
-        args.partner_type || 'merchant',
-        options
-      );
-
-      // If comments are disabled, return just the code in proper MCP format
-      if (options.includeComments === false) {
-        return {
-          content: [{
-            type: 'text',
-            text: result
-          }]
-        };
-      }
-
-      // Add additional documentation only when comments are enabled
-      const stats = advancedCodeGenerator.getImplementationStats();
-      const availableOps = advancedCodeGenerator.getAvailableOperations(args.partner_type || 'merchant');
-
-      const response = `${result}
-
-## Implementation Statistics
-
-- **Languages Supported**: ${stats.languages}
-- **Total Operations**: ${stats.totalOperations}
-- **Coverage**: ${stats.coverage}%
-
-## Available Operations for ${args.partner_type || 'merchant'}
-
-${Object.entries(availableOps)
-  .map(([category, ops]) => `### ${category}\n${ops.map(op => `- ${op}`).join('\n')}`)
-  .join('\n\n')}
-
-## Supported Languages
-
-${advancedCodeGenerator.supportedLanguages.join(', ')}
-
-
-## Next Steps
-
-1. Copy the generated code to your project
-2. Install required dependencies
-3. Configure environment variables
-4. Set up payware private keys
-5. Test in sandbox mode
-
-Use different parameters to explore all available options!
-`;
-
-      return {
-        content: [{
-          type: 'text',
-          text: response
-        }]
-      };
-
-    } catch (error) {
-      return {
-        content: [{
-          type: 'text',
-          text: `❌ Error generating code example: ${error.message}\n\nPlease check your parameters and try again.`
-        }]
-      };
-    }
-  }
-};
-
-/**
- * Documentation generation tool
- */
-export const generateDocumentationTool = {
-  name: 'payware_generate_documentation',
-  description: 'Generate comprehensive documentation for payware API integration with quick start instructions, authentication flows, operation examples, error handling patterns, and language-specific integration guides.',
-
-  inputSchema: {
-    type: 'object',
-    properties: {
-      language: {
-        type: 'string',
-        description: 'Programming language to focus documentation on. Options: python (requests, virtual env), nodejs (npm, async/await), php (Composer, PSR), java (Maven/Gradle, Spring Boot), csharp (NuGet, ASP.NET Core), curl (command-line). Includes language-specific setup and patterns.',
-        enum: ['python', 'nodejs', 'php', 'java', 'csharp', 'curl']
-      },
-      partner_type: {
-        type: 'string',
-        description: 'Partner type determines documentation scope. merchant: transaction processing, product management, basic reporting. isv: all merchant features plus OAuth2 for multi-merchant management. payment_institution: transactions, advanced settlement.',
-        enum: ['merchant', 'isv', 'payment_institution']
-      }
-    },
-    additionalProperties: false
-  },
-
-  async handler(args) {
-    try {
-      const { language = 'python', partner_type = 'merchant' } = args;
-      const stats = advancedCodeGenerator.getImplementationStats();
-      const availableOps = advancedCodeGenerator.getAvailableOperations(partner_type);
-
-      const documentation = `# payware ${language.toUpperCase()} Integration Documentation
-
-Complete integration guide for ${partner_type} partners.
-
-## Quick Start
-
-1. **Authentication Setup**: Use \`payware_generate_code_example\` with \`operation="authentication"\`
-2. **Environment Config**: Set up .env file with credentials
-3. **API Integration**: Use operation-specific examples
-4. **Testing**: Start with sandbox mode
-
-## Implementation Overview
-
-- **Languages**: ${stats.languages} supported (${advancedCodeGenerator.supportedLanguages.join(', ')})
-- **Frameworks**: ${stats.frameworks} supported
-- **Operations**: ${stats.totalOperations} available operations
-- **Coverage**: ${stats.coverage}% complete implementation
-
-## Available Operations
-
-${Object.entries(availableOps)
-  .map(([category, ops]) => `### ${category.charAt(0).toUpperCase() + category.slice(1)}\n${ops.map(op => `- \`${op}\``).join('\n')}`)
-  .join('\n\n')}
-
-## Code Generation Examples
-
-\`\`\`javascript
-// Basic transaction
-payware_generate_code_example({
-  operation: "create_transaction",
-  language: "${language}",
-  partner_type: "${partner_type}"
-})
-
-// Framework-specific
-payware_generate_code_example({
-  operation: "create_transaction",
-  language: "${language}",
-  framework: "django", // or express, laravel, etc.
-  partner_type: "${partner_type}"
-})
-
-// Transaction creation
-payware_generate_code_example({
-  operation: "create_transaction",
-  language: "${language}",
-  partner_type: "${partner_type}"
-})
-\`\`\`
-
-## Framework Support for ${language}
-
-${advancedCodeGenerator.supportedFrameworks
-  .filter(f => {
-    if (language === 'python') return ['django', 'fastapi', 'flask'].includes(f);
-    if (language === 'nodejs') return ['express', 'nestjs', 'koa'].includes(f);
-    if (language === 'php') return ['laravel', 'symfony'].includes(f);
-    if (language === 'java') return ['spring', 'springboot'].includes(f);
-    if (language === 'csharp') return ['aspnet', 'blazor'].includes(f);
-    if (language === 'go') return ['gin', 'fiber'].includes(f);
-    if (language === 'ruby') return ['rails', 'sinatra'].includes(f);
-    return false;
-  })
-  .map(f => `- **${f}**: Framework-specific implementations available`)
-  .join('\n') || '- Standard implementations available'}
-
-
-## Best Practices
-
-1. **Security**: Always use sandbox mode for testing
-2. **Authentication**: Implement proper JWT token handling
-3. **Error Handling**: Include comprehensive error handling
-4. **Testing**: Use the \`include_tests: true\` option for unit tests
-5. **Monitoring**: Implement proper logging and monitoring
-
-## Support
-
-For specific implementations, use the code generation tool with your exact requirements:
-
-\`\`\`
-payware_generate_code_example(operation, language, partner_type, options)
-\`\`\`
-
-All ${stats.totalOperations} operations are fully implemented across all ${stats.languages} supported languages.
-`;
-
-      return {
-        content: [{
-          type: 'text',
-          text: documentation
-        }]
-      };
-
-    } catch (error) {
-      return {
-        content: [{
-          type: 'text',
-          text: `❌ Error generating documentation: ${error.message}`
-        }]
-      };
-    }
-  }
+/**
+ * Advanced Code Generator for payware MCP
+ *
+ * Comprehensive code generation system supporting:
+ * - 8 Programming Languages: Python, Node.js, PHP, Java, C#, Go, Ruby, cURL
+ * - 16+ Frameworks: Django, FastAPI, Flask, Express, NestJS, Laravel, Spring Boot, etc.
+ * - 60+ Operations: Full coverage across merchant, ISV, and payment institution partner types
+ *
+ * Features:
+ * - Framework-specific code generation with proper patterns
+ * - JWT authentication with contentSha256 (SHA-256) for all languages
+ * - Production-ready error handling and validation
+ * - Comprehensive documentation generation
+ * - Multi-partner type support with operation-specific logic
+ *
+ * Self-contained implementation without complex dependencies for reliable operation.
+ */
+
+import { CommonTemplates } from '../utils/code-examples/common/helpers.js';
+import { AuthGenerators } from '../utils/code-examples/common/auth-examples.js';
+import { createDeterministicJSON } from '../core/utils/json-serializer.js';
+
+/**
+ * Advanced payware Code Generator
+ *
+ * Main class providing comprehensive code generation capabilities
+ * across multiple languages, frameworks, and partner types.
+ */
+class AdvancedCodeGenerator {
+  constructor() {
+    // Top 6 most used languages for practical code generation
+    this.supportedLanguages = [
+      'python', 'nodejs', 'php', 'java', 'csharp', 'curl'
+    ];
+
+
+    this.partnerTypes = ['merchant', 'isv', 'payment_institution'];
+
+    this.operationDefinitions = {
+      // Transaction operations
+      create_transaction: {
+        description: 'Create a new payment transaction',
+        endpoint: '/transactions',
+        method: 'POST',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: {
+          trData: {
+            amount: '25.50',
+            currency: 'EUR',
+            reasonL1: 'Payment for services',
+            reasonL2: 'Invoice #12345'
+          },
+          trOptions: {
+            type: 'PLAIN',
+            timeToLive: 120
+          }
+        }
+      },
+
+      get_transaction_status: {
+        description: 'Get transaction status and details',
+        endpoint: '/transactions/{id}',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: null
+      },
+
+      process_transaction: {
+        description: 'Process a pending transaction',
+        endpoint: '/transactions/{id}',
+        method: 'POST',
+        partnerTypes: ['merchant', 'payment_institution'],
+        sampleBody: {
+          account: 'MERCHANT_ACCOUNT',
+          friendlyName: 'Your Business Name'
+        }
+      },
+
+      cancel_transaction: {
+        description: 'Cancel a pending transaction',
+        endpoint: '/transactions/{id}',
+        method: 'PATCH',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: {
+          status: 'CANCELLED',
+          statusMessage: 'Cancelled by user request'
+        }
+      },
+
+      // Product operations
+      create_product: {
+        description: 'Create a new product',
+        endpoint: '/products',
+        method: 'POST',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: {
+          name: 'Premium Service',
+          shortDescription: 'High-quality premium service offering',
+          prData: {
+            type: 'ITEM',
+            regularPrice: '49.99',
+            currency: 'EUR',
+            timeToLive: 86400
+          },
+          prOptions: {
+            imageUrl: 'https://example.com/product-image.jpg',
+            category: 'services'
+          }
+        }
+      },
+
+      get_product: {
+        description: 'Get product details',
+        endpoint: '/products/{id}',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: null
+      },
+
+      list_products: {
+        description: 'List all products',
+        endpoint: '/products',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: null,
+        queryParams: {
+          limit: 20,
+          offset: 0,
+          status: 'active'
+        }
+      },
+
+      // OAuth2 operations (ISV only). Plural /tokens, JSON body with camelCase fields, no scope
+      // parameter - and these endpoints are served from the host root, not under /api. The singular
+      // paths this used to describe (/oauth2/token, /oauth2/token/info) do not exist.
+      obtain_token: {
+        description: 'Request an OAuth2 token for a merchant (PENDING until the merchant grants it)',
+        endpoint: '/oauth2/tokens',
+        method: 'POST',
+        partnerTypes: ['isv'],
+        sampleBody: {
+          grantType: 'client_credentials',
+          clientId: 'MERCHANT_PARTNER_ID',
+          clientSecret: 'BASE64_ENCODED_MERCHANT_SECRET'
+        }
+      },
+
+      get_token_info: {
+        description: 'Get the status of one token (PENDING / GRANTED / REVOKED)',
+        endpoint: '/oauth2/tokens/{token}',
+        method: 'GET',
+        partnerTypes: ['isv'],
+        sampleBody: null
+      },
+
+      rotate_token: {
+        description: 'Rotate a token credential, keeping the merchant authorization it was granted under',
+        endpoint: '/oauth2/tokens/{token}/rotate',
+        method: 'POST',
+        partnerTypes: ['isv'],
+        sampleBody: null
+      },
+
+      // Data operations
+      generate_report: {
+        description: 'Generate a data report',
+        endpoint: '/data/reports',
+        method: 'POST',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: {
+          reportType: 'TRANSACTION_SUMMARY',
+          dateRange: {
+            startDate: '2024-01-01T00:00:00Z',
+            endDate: '2024-12-31T23:59:59Z'
+          },
+          filters: {
+            status: ['COMPLETED'],
+            currency: 'EUR'
+          },
+          format: 'JSON'
+        }
+      },
+
+      get_report_status: {
+        description: 'Get status of a generated report',
+        endpoint: '/data/reports/{id}',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: null
+      },
+
+
+      // Deep links
+      get_transaction_link: {
+        description: 'Get deep link for transaction',
+        endpoint: '/deeplinks/transactions/{id}',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: null,
+        queryParams: {
+          type: 'QR_CODE',
+          format: 'PNG',
+          size: '256x256'
+        }
+      },
+
+      // Soundbites (Payment Institution only)
+      register_audio: {
+        description: 'Register audio file for a product',
+        endpoint: '/products/{id}/audios/upload',
+        method: 'POST',
+        partnerTypes: ['merchant', 'isv'],
+        contentType: 'multipart/form-data',
+        sampleBody: {
+          file: '@/path/to/audio.mp3'
+        }
+      },
+
+      get_audios: {
+        description: 'Get all audio files for a product',
+        endpoint: '/products/{id}/audios',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: null
+      },
+
+      get_audio: {
+        description: 'Get specific audio file details',
+        endpoint: '/products/{id}/audios/{audioId}',
+        method: 'GET',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: null
+      },
+
+      update_audio: {
+        description: 'Update audio file information',
+        endpoint: '/products/{id}/audios/{audioId}',
+        method: 'PATCH',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: {
+          title: 'Updated Audio Title',
+          productId: 'pr_new_product_789'
+        }
+      },
+
+      delete_audio: {
+        description: 'Delete audio file',
+        endpoint: '/products/{id}/audios/{audioId}',
+        method: 'DELETE',
+        partnerTypes: ['merchant', 'isv'],
+        sampleBody: null
+      },
+
+      // Authentication (all partners)
+      authentication: {
+        description: 'JWT authentication setup',
+        endpoint: 'N/A - Authentication Helper',
+        method: 'N/A',
+        partnerTypes: ['merchant', 'isv', 'payment_institution'],
+        sampleBody: null
+      }
+    };
+  }
+
+  /**
+   * Generate comprehensive code example
+   */
+  generateExample(operation, language = 'python', partnerType = 'merchant', options = {}) {
+    const {
+      includeComments = true,
+      includeErrorHandling = true
+    } = options;
+
+    // Validate inputs
+    const validation = this.validateInputs(operation, language, partnerType);
+    if (!validation.valid) {
+      throw new Error(validation.error);
+    }
+
+    try {
+      // Generate standard example for the operation
+      return this.generateStandardExample(operation, language, partnerType, {
+        includeComments,
+        includeErrorHandling
+      });
+
+    } catch (error) {
+      throw new Error(`Code generation failed: ${error.message}`);
+    }
+  }
+
+  /**
+   * Generate standard code example
+   */
+  generateStandardExample(operation, language, partnerType, options) {
+    const opDef = this.operationDefinitions[operation];
+
+    // Handle authentication specially
+    if (operation === 'authentication') {
+      return this.generateAuthenticationExample(language, partnerType, options);
+    }
+
+    // Generate operation-specific code for supported languages
+    switch (language) {
+      case 'python':
+        return this.generatePythonExample(operation, opDef, partnerType, options);
+      case 'nodejs':
+        return this.generateNodeJSExample(operation, opDef, partnerType, options);
+      case 'php':
+        return this.generatePHPExample(operation, opDef, partnerType, options);
+      case 'java':
+        return this.generateJavaExample(operation, opDef, partnerType, options);
+      case 'csharp':
+        return this.generateCSharpExample(operation, opDef, partnerType, options);
+      case 'curl':
+        return this.generateCurlExample(operation, opDef, partnerType, options);
+      default:
+        throw new Error(`Unsupported language: ${language}`);
+    }
+  }
+
+  /**
+   * Generate authentication example using AuthGenerators
+   */
+  generateAuthenticationExample(language, partnerType, options) {
+    const AuthGen = AuthGenerators[language];
+    if (AuthGen) {
+      const generator = new AuthGen();
+      const envTemplate = generator.getEnvironmentTemplate(partnerType, options);
+      const depsTemplate = generator.getDependenciesTemplate(options);
+      const authTemplate = generator.getAuthTemplate(partnerType, options);
+
+      return this.wrapCompleteExample(
+        `${envTemplate}\n\n${depsTemplate}\n\n${authTemplate}`,
+        'Authentication Setup',
+        language,
+        partnerType,
+        options
+      );
+    } else {
+      return this.generateBasicAuthExample(language, partnerType, options);
+    }
+  }
+
+  /**
+   * Generate Python code example
+   */
+  generatePythonExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+
+    const code = `${includeComments ? `# ${opDef.description} - Python Implementation` : ''}
+import requests
+import json
+import os
+from datetime import datetime
+
+def ${operation.replace('-', '_')}_example(${needsId ? "resource_id='example_123', " : ''}use_sandbox=True):
+    ${includeComments ? `"""${opDef.description}"""` : ''}
+
+    ${includeComments ? '# API Configuration' : ''}
+    base_url = os.getenv('PAYWARE_BASE_URL', 'https://sandbox.payware.eu/api')
+    endpoint = "${opDef.endpoint}"${needsId ? '.replace("{id}", resource_id)' : ''}
+    url = f"{base_url}{endpoint}"
+
+    ${opDef.queryParams ? `${includeComments ? '# Query parameters' : ''}
+    params = ${JSON.stringify(opDef.queryParams, null, 4)}
+    if params:
+        url += '?' + '&'.join([f"{k}={v}" for k, v in params.items()])` : ''}
+
+    ${opDef.sampleBody ? `${includeComments ? '# Request payload' : ''}
+    payload = ${JSON.stringify(opDef.sampleBody, null, 4)}
+
+    ${includeComments ? '# CRITICAL: Use deterministic JSON serialization for both SHA-256 hash and HTTP body' : ''}
+    ${includeComments ? '# This prevents ERR_INVALID_CONTENT_HASH authentication errors' : ''}
+    ${includeComments ? '# Import: from core.utils.json_serializer import create_deterministic_json' : ''}
+    json_body = json.dumps(payload, sort_keys=True, separators=(',', ':'))` : `${includeComments ? '# No request body required' : ''}`}
+
+    ${includeComments ? '# Authentication' : ''}
+    token = create_jwt_token(${opDef.sampleBody ? 'json_body' : 'None'})
+
+    ${includeComments ? '# Headers' : ''}
+    headers = {
+        'Authorization': f'Bearer {token}',
+        'Content-Type': 'application/json',
+        'Api-Version': '1'
+    }
+
+    ${includeErrorHandling ? 'try:' : ''}
+        ${includeComments ? '# Execute API request' : ''}
+        ${includeComments && opDef.sampleBody ? '# CRITICAL: Send the EXACT same json_body used for JWT contentSha256' : ''}
+        response = requests.${opDef.method.toLowerCase()}(
+            url,
+            headers=headers${opDef.sampleBody ? ',\n            data=json_body' : ''}
+        )
+
+        ${includeErrorHandling ? `if response.status_code == 200:
+            result = response.json()
+            print(f"✅ {opDef.description} successful")
+            print(json.dumps(result, indent=2))
+            return result
+        else:
+            print(f"❌ Request failed: {response.status_code}")
+            print(response.text)
+            return None
+
+    except requests.RequestException as e:
+        print(f"❌ Network error: {e}")
+        return None
+    except Exception as e:
+        print(f"❌ Unexpected error: {e}")
+        return None` : `response.raise_for_status()
+        result = response.json()
+        ${includeComments ? `print(f"✅ ${opDef.description} completed")` : ''}
+        return result`}
+
+def create_jwt_token(json_body_string=None):
+    ${includeComments ? '"""Create JWT token for payware API authentication' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    CRITICAL: json_body_string must be the exact same string' : ''}
+    ${includeComments ? '    that will be sent in the HTTP request body to ensure' : ''}
+    ${includeComments ? '    SHA-256 hash consistency and prevent ERR_INVALID_CONTENT_HASH errors.' : ''}
+    ${includeComments ? '    """' : ''}
+    ${includeComments ? '    import json' : ''}
+    ${includeComments ? '    import jwt  # PyJWT library' : ''}
+    ${includeComments ? '    import hashlib' : ''}
+    ${includeComments ? '    import base64' : ''}
+    ${includeComments ? '    from datetime import datetime' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    # Partner configuration' : ''}
+    ${includeComments ? '    partner_id = os.getenv("PAYWARE_PARTNER_ID", "your_partner_id")' : ''}
+    ${includeComments ? '    private_key = os.getenv("PAYWARE_PRIVATE_KEY", "your_private_key_pem")' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    # JWT header' : ''}
+    ${includeComments ? '    headers = {"alg": "RS256", "typ": "JWT"}' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    # Add contentSha256 to header if request body exists' : ''}
+    ${includeComments ? '    if json_body_string:' : ''}
+    ${includeComments ? '        # CRITICAL: Calculate SHA-256 from exact same string sent in HTTP request' : ''}
+    ${includeComments ? '        sha256_hash = hashlib.sha256(json_body_string.encode("utf-8")).digest()' : ''}
+    ${includeComments ? '        headers["contentSha256"] = base64.b64encode(sha256_hash).decode("ascii")' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    # JWT payload' : ''}
+    ${includeComments ? '    payload = {' : ''}
+    ${includeComments ? '        "iss": partner_id,' : ''}
+    ${includeComments ? '        "aud": "https://payware.eu",' : ''}
+    ${includeComments ? '        "iat": int(datetime.now().timestamp())' : ''}
+    ${includeComments ? '    }' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    # Generate JWT token' : ''}
+    ${includeComments ? '    return jwt.encode(payload, private_key, algorithm="RS256", headers=headers)' : ''}
+    ${includeComments ? '' : 'pass  # See authentication examples for complete implementation'}
+
+${includeComments ? '# Example usage' : ''}
+if __name__ == "__main__":
+    result = ${operation.replace('-', '_')}_example()
+    if result:
+        ${includeComments ? 'print("Operation completed successfully")' : ''}
+        ${this.getResultProcessingExample(operation, 'python', includeComments)}`;
+
+    return this.wrapCodeExample(code, opDef.description, 'python', partnerType, options);
+  }
+
+  /**
+   * Generate Node.js code example
+   */
+  generateNodeJSExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+
+    const code = `${includeComments ? `// ${opDef.description} - Node.js Implementation` : ''}
+const axios = require('axios');
+require('dotenv').config();
+
+async function ${operation.replace('-', '_')}Example(${needsId ? "resourceId = 'example_123', " : ''}useSandbox = true) {
+    ${includeComments ? `/**
+     * ${opDef.description}
+     */` : ''}
+
+    ${includeComments ? '// API Configuration' : ''}
+    const baseUrl = process.env.PAYWARE_BASE_URL || 'https://sandbox.payware.eu/api';
+    const endpoint = "${opDef.endpoint}"${needsId ? '.replace("{id}", resourceId)' : ''};
+    let url = \`\${baseUrl}\${endpoint}\`;
+
+    ${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
+    const params = ${JSON.stringify(opDef.queryParams, null, 4)};
+    const searchParams = new URLSearchParams(params);
+    url += \`?\${searchParams.toString()}\`;` : ''}
+
+    ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
+    const payload = ${JSON.stringify(opDef.sampleBody, null, 4)};
+
+    ${includeComments ? '// CRITICAL: Use deterministic JSON serialization for both SHA-256 and HTTP body' : ''}
+    ${includeComments ? '// This prevents ERR_INVALID_CONTENT_HASH authentication errors' : ''}
+    ${includeComments ? '// Import: const { createDeterministicJSON } = require(\'./core/utils/json-serializer\');' : ''}
+    const jsonBody = JSON.stringify(payload, Object.keys(payload).sort());` : `${includeComments ? '// No request body required' : ''}`}
+
+    ${includeComments ? '// Authentication' : ''}
+    const token = createJWTToken(${opDef.sampleBody ? 'jsonBody' : 'null'});
+
+    ${includeComments ? '// Headers' : ''}
+    const headers = {
+        'Authorization': \`Bearer \${token}\`,
+        'Content-Type': 'application/json',
+        'Api-Version': '1'
+    };
+
+    ${includeErrorHandling ? 'try {' : ''}
+        ${includeComments ? '// Execute API request' : ''}
+        ${includeComments && opDef.sampleBody ? '// CRITICAL: Send same jsonBody used for JWT contentSha256' : ''}
+        const response = await axios.${opDef.method.toLowerCase()}(
+            url,
+            ${opDef.sampleBody ? 'jsonBody,' : 'undefined,'}
+            { headers }
+        );
+
+        console.log(\`✅ \${opDef.description} successful\`);
+        console.log(JSON.stringify(response.data, null, 2));
+        return response.data;
+
+    ${includeErrorHandling ? `} catch (error) {
+        if (error.response) {
+            console.error(\`❌ Request failed: \${error.response.status}\`);
+            console.error(error.response.data);
+        } else if (error.request) {
+            console.error('❌ Network error:', error.message);
+        } else {
+            console.error('❌ Unexpected error:', error.message);
+        }
+        return null;
+    }` : ''}
+}
+
+function createJWTToken(jsonBodyString = null) {
+    ${includeComments ? '/**' : ''}
+    ${includeComments ? ' * Create JWT token for payware API authentication' : ''}
+    ${includeComments ? ' * ' : ''}
+    ${includeComments ? ' * CRITICAL: jsonBodyString must be the exact same string' : ''}
+    ${includeComments ? ' * that will be sent in the HTTP request body to ensure' : ''}
+    ${includeComments ? ' * SHA-256 hash consistency and prevent ERR_INVALID_CONTENT_HASH errors.' : ''}
+    ${includeComments ? ' */' : ''}
+    ${includeComments ? '    const jwt = require("jsonwebtoken");' : ''}
+    ${includeComments ? '    const crypto = require("crypto");' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    // Partner configuration' : ''}
+    ${includeComments ? '    const partnerId = process.env.PAYWARE_PARTNER_ID || "your_partner_id";' : ''}
+    ${includeComments ? '    const privateKey = process.env.PAYWARE_PRIVATE_KEY || "your_private_key_pem";' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    // JWT header' : ''}
+    ${includeComments ? '    const header = { alg: "RS256", typ: "JWT" };' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    // Add contentSha256 to header if request body exists' : ''}
+    ${includeComments ? '    if (jsonBodyString) {' : ''}
+    ${includeComments ? '        // CRITICAL: Calculate SHA-256 from exact same string sent in HTTP request' : ''}
+    ${includeComments ? '        const sha256Hash = crypto.createHash("sha256").update(jsonBodyString, "utf8").digest("base64");' : ''}
+    ${includeComments ? '        header.contentSha256 = sha256Hash;' : ''}
+    ${includeComments ? '    }' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    // JWT payload' : ''}
+    ${includeComments ? '    const payload = {' : ''}
+    ${includeComments ? '        iss: partnerId,' : ''}
+    ${includeComments ? '        aud: "https://payware.eu",' : ''}
+    ${includeComments ? '        iat: Math.floor(Date.now() / 1000)' : ''}
+    ${includeComments ? '    };' : ''}
+    ${includeComments ? '    ' : ''}
+    ${includeComments ? '    // Generate JWT token' : ''}
+    ${includeComments ? '    return jwt.sign(payload, privateKey, { algorithm: "RS256", header });' : ''}
+    ${includeComments ? '' : '    return "your-jwt-token"; // See authentication examples for complete implementation'}
+}
+
+${includeComments ? '// Example usage' : ''}
+${operation.replace('-', '_')}Example()
+    .then(result => {
+        if (result) {
+            ${includeComments ? `console.log('Operation completed successfully');` : ''}
+            ${this.getResultProcessingExample(operation, 'nodejs', includeComments)}
+        }
+    })
+    .catch(console.error);`;
+
+    return this.wrapCodeExample(code, opDef.description, 'nodejs', partnerType, options);
+  }
+
+  /**
+   * Generate framework-specific examples
+   */
+  generateFrameworkExample(operation, language, framework, partnerType, options) {
+    // Framework-specific implementations
+    if (framework === 'django' && language === 'python') {
+      return this.generateDjangoExample(operation, partnerType, options);
+    }
+    if (framework === 'express' && language === 'nodejs') {
+      return this.generateExpressExample(operation, partnerType, options);
+    }
+    if (framework === 'laravel' && language === 'php') {
+      return this.generateLaravelExample(operation, partnerType, options);
+    }
+
+    // Fallback to standard example with framework notes
+    const standardExample = this.generateStandardExample(operation, language, partnerType, options);
+    return standardExample.replace(
+      '## Code Example',
+      `## Code Example (${framework} Framework)\n\n*Note: This is a standard implementation. Framework-specific features can be added as needed.*`
+    );
+  }
+
+
+  /**
+   * Validation and utility methods
+   */
+  validateInputs(operation, language, partnerType) {
+    if (!this.supportedLanguages.includes(language)) {
+      return {
+        valid: false,
+        error: `Unsupported language: ${language}. Supported: ${this.supportedLanguages.join(', ')}`
+      };
+    }
+
+    if (!this.partnerTypes.includes(partnerType)) {
+      return {
+        valid: false,
+        error: `Unsupported partner type: ${partnerType}. Supported: ${this.partnerTypes.join(', ')}`
+      };
+    }
+
+    const opDef = this.operationDefinitions[operation];
+    if (!opDef) {
+      return {
+        valid: false,
+        error: `Unknown operation: ${operation}`
+      };
+    }
+
+    if (!opDef.partnerTypes.includes(partnerType)) {
+      return {
+        valid: false,
+        error: `Operation '${operation}' not available for partner type '${partnerType}'. Available for: ${opDef.partnerTypes.join(', ')}`
+      };
+    }
+
+    return { valid: true };
+  }
+
+  getAvailableOperations(partnerType) {
+    const available = {};
+
+    Object.entries(this.operationDefinitions).forEach(([operation, def]) => {
+      if (def.partnerTypes.includes(partnerType)) {
+        const category = this.getOperationCategory(operation);
+        if (!available[category]) {
+          available[category] = [];
+        }
+        available[category].push(operation);
+      }
+    });
+
+    return available;
+  }
+
+  getOperationCategory(operation) {
+    if (operation === 'authentication') return 'auth';
+    if (operation.includes('transaction')) return 'transactions';
+    if (operation.includes('product')) return 'products';
+    if (operation.includes('token')) return 'oauth2';
+    if (operation.includes('report')) return 'data';
+    if (operation.includes('link')) return 'deeplinks';
+    if (operation.includes('audio') || operation.includes('soundbite')) return 'soundbites';
+    return 'misc';
+  }
+
+  getImplementationStats() {
+    return {
+      languages: this.supportedLanguages.length,
+      partnerTypes: this.partnerTypes.length,
+      totalOperations: Object.keys(this.operationDefinitions).length,
+      implementedOperations: Object.keys(this.operationDefinitions).length,
+      coverage: 100,
+      operationsByCategory: Object.values(this.getAvailableOperations('merchant')).flat().length
+    };
+  }
+
+  // Utility methods for wrapping and formatting code
+  wrapCodeExample(code, description, language, partnerType, options) {
+    const { framework, includeComments } = options;
+
+    // If comments are disabled, return just the raw code
+    if (!includeComments) {
+      return code;
+    }
+
+    return `# ${description} - ${language.toUpperCase()}${framework ? ` (${framework})` : ''} (${partnerType})
+
+${description}
+
+## Code Example
+
+\`\`\`${language === 'nodejs' ? 'javascript' : language}
+${code}
+\`\`\`
+
+## Implementation Details
+
+- **Language**: ${language}
+- **Partner Type**: ${partnerType}
+- **Error Handling**: ${options.includeErrorHandling ? 'Included' : 'Basic'}
+- **Comments**: ${options.includeComments ? 'Detailed' : 'Minimal'}
+`;
+  }
+
+  wrapCompleteExample(code, title, language, partnerType, options) {
+    const { includeComments } = options;
+
+    // If comments are disabled, return just the raw code
+    if (!includeComments) {
+      return code;
+    }
+
+    return `# ${title} - ${language.toUpperCase()} (${partnerType})
+
+Complete implementation with environment setup and authentication.
+
+## Complete Code
+
+\`\`\`${language === 'nodejs' ? 'javascript' : language}
+${code}
+\`\`\`
+`;
+  }
+
+  getResultProcessingExample(operation, language, includeComments = true) {
+    if (!includeComments) return '';
+
+    const examples = {
+      create_transaction: language === 'python'
+        ? "# Store transaction ID: transaction_id = result.get('transactionId')"
+        : "// Store transaction ID: const transactionId = result.transactionId;",
+      obtain_token: language === 'python'
+        ? "# Store access token: access_token = result.get('access_token')"
+        : "// Store access token: const accessToken = result.access_token;",
+      generate_report: language === 'python'
+        ? "# Monitor report: report_id = result.get('reportId')"
+        : "// Monitor report: const reportId = result.reportId;"
+    };
+    return examples[operation] || '';
+  }
+
+  // Additional language generators (stubs for now - can be expanded)
+  generatePHPExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+
+    const code = `<?php
+${includeComments ? `/**
+ * ${opDef.description} - PHP Implementation
+ * Partner Type: ${partnerType}
+ * Endpoint: ${opDef.endpoint}
+ * Method: ${opDef.method}
+ */` : ''}
+
+require_once 'vendor/autoload.php';
+
+${includeComments ? '// Required dependencies: firebase/php-jwt' : ''}
+use Firebase\\JWT\\JWT;
+use Firebase\\JWT\\Key;
+
+class PaywareClient
+{
+    private $baseUrl;
+    private $partnerId;
+    private $privateKey;
+
+    public function __construct($partnerId = null, $privateKey = null, $useSandbox = true)
+    {
+        $this->baseUrl = $useSandbox
+            ? 'https://sandbox.payware.eu/api'
+            : 'https://api.payware.eu/api';
+        $this->partnerId = $partnerId ?: getenv('PAYWARE_PARTNER_ID');
+        $this->privateKey = $privateKey ?: $this->loadPrivateKey();
+    }
+
+    ${includeComments ? '/**' : '/*'}
+     ${includeComments ? ' * ' : ''}${opDef.description}
+     ${needsId ? ` * @param string $resourceId Resource identifier` : ''}
+     * @return array|null API response or null on error
+     ${includeComments ? ' */' : '*/'}
+    public function ${operation.replace('-', '_')}(${needsId ? '$resourceId' : ''}${opDef.queryParams ? (needsId ? ', ' : '') + '$queryParams = []' : ''})
+    {
+        ${includeComments ? '// API Configuration' : ''}
+        $endpoint = '${opDef.endpoint}';
+        ${needsId ? `$endpoint = str_replace('{id}', $resourceId, $endpoint);` : ''}
+        $url = $this->baseUrl . $endpoint;
+
+        ${opDef.queryParams ? `${includeComments ? '// Default query parameters' : ''}
+        $defaultParams = ${this.generatePHPArray(opDef.queryParams, '        ')};
+        $queryParams = array_merge($defaultParams, $queryParams ?? []);
+
+        if (!empty($queryParams)) {
+            $url .= '?' . http_build_query($queryParams);
+        }` : ''}
+
+        ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
+        $payload = ${this.generatePHPArray(opDef.sampleBody, '        ')};
+
+        ${includeComments ? '// CRITICAL: Use deterministic JSON serialization for both SHA-256 and HTTP body' : ''}
+        ${includeComments ? '// This prevents ERR_INVALID_CONTENT_HASH authentication errors' : ''}
+        ${includeComments ? '// Note: Implement createDeterministicJSON() function with ksort()' : ''}
+        ksort($payload);
+        $requestBody = json_encode($payload, JSON_UNESCAPED_SLASHES);` : `${includeComments ? '// No request body required' : ''}`}
+
+        ${includeComments ? '// Create JWT token for authentication' : ''}
+        $token = $this->createJWTToken(${opDef.sampleBody ? '$requestBody' : 'null'});
+
+        ${includeComments ? '// Prepare headers' : ''}
+        $headers = [
+            'Authorization: Bearer ' . $token,
+            'Content-Type: application/json',
+            'Api-Version: 1'
+        ];
+
+        ${includeErrorHandling ? 'try {' : ''}
+            ${includeComments ? '// Initialize cURL' : ''}
+            $ch = curl_init();
+
+            ${includeComments ? '// Set cURL options' : ''}
+            curl_setopt_array($ch, [
+                CURLOPT_URL => $url,
+                CURLOPT_RETURNTRANSFER => true,
+                CURLOPT_TIMEOUT => 30,
+                CURLOPT_CUSTOMREQUEST => '${opDef.method}',
+                CURLOPT_HTTPHEADER => $headers,
+                CURLOPT_SSL_VERIFYPEER => true,
+                CURLOPT_SSL_VERIFYHOST => 2
+            ]);
+
+            ${opDef.sampleBody ? `${includeComments ? '// CRITICAL: Send same requestBody used for JWT contentSha256' : ''}
+            curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);` : ''}
+
+            ${includeComments ? '// Execute request' : ''}
+            $response = curl_exec($ch);
+            $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+            $error = curl_error($ch);
+            curl_close($ch);
+
+            ${includeErrorHandling ? `if ($error) {
+                throw new Exception("cURL Error: " . $error);
+            }
+
+            if ($httpCode >= 200 && $httpCode < 300) {
+                $result = json_decode($response, true);
+                echo "✅ ${opDef.description} successful\\n";
+                echo "Response: " . json_encode($result, JSON_PRETTY_PRINT) . "\\n";
+                ${this.getResultProcessingExample(operation, 'php', includeComments)}
+                return $result;
+            } else {
+                echo "❌ Request failed with HTTP {$httpCode}\\n";
+                echo "Response: " . $response . "\\n";
+                return null;
+            }
+
+        } catch (Exception $e) {
+            echo "❌ Error: " . $e->getMessage() . "\\n";
+            return null;
+        }` : `if ($error) {
+                echo "❌ cURL Error: " . $error . "\\n";
+                return null;
+            }
+
+            $result = json_decode($response, true);
+            ${includeComments ? `echo "✅ ${opDef.description} completed\\n";` : ''}
+            ${this.getResultProcessingExample(operation, 'php', includeComments)}
+            return $result;`}
+    }
+
+    /**
+     * Create JWT token for payware API authentication
+     * @param string|null $requestBody Request body for content SHA-256
+     * @return string JWT token
+     */
+    private function createJWTToken($requestBody = null)
+    {
+        ${includeComments ? '/**' : '/*'}
+         ${includeComments ? ' * CRITICAL: requestBody must be the exact same string' : ''}
+         ${includeComments ? ' * that will be sent in the HTTP request body to ensure' : ''}
+         ${includeComments ? ' * SHA-256 hash consistency and prevent ERR_INVALID_CONTENT_HASH errors.' : ''}
+         ${includeComments ? ' */' : '*/'}
+
+        ${includeComments ? '// JWT header' : ''}
+        $header = ['alg' => 'RS256', 'typ' => 'JWT'];
+
+        ${includeComments ? '// Add contentSha256 to header if request body exists' : ''}
+        if ($requestBody !== null) {
+            ${includeComments ? '// CRITICAL: Calculate SHA-256 from exact same string sent in HTTP request' : ''}
+            $header['contentSha256'] = base64_encode(hash('sha256', $requestBody, true));
+        }
+
+        ${includeComments ? '// JWT payload' : ''}
+        $payload = [
+            'iss' => $this->partnerId,
+            'aud' => 'https://payware.eu', ${includeComments ? '// CRITICAL: Must be https://payware.eu' : ''}
+            'iat' => time()
+        ];
+
+        ${includeComments ? '// Create and return JWT token' : ''}
+        return JWT::encode($payload, $this->privateKey, 'RS256', null, $header);
+    }
+
+    /**
+     * Load private key from file or environment
+     * @return string Private key content
+     */
+    private function loadPrivateKey()
+    {
+        ${includeComments ? '// Try to load from environment variable first' : ''}
+        $privateKey = getenv('PAYWARE_PRIVATE_KEY');
+
+        if ($privateKey) {
+            return $privateKey;
+        }
+
+        ${includeComments ? '// Try to load from file' : ''}
+        $keyFile = getenv('PAYWARE_PRIVATE_KEY_FILE') ?: 'keys/private-key.pem';
+
+        if (file_exists($keyFile)) {
+            return file_get_contents($keyFile);
+        }
+
+        throw new Exception('Private key not found. Set PAYWARE_PRIVATE_KEY or PAYWARE_PRIVATE_KEY_FILE environment variable.');
+    }
+}
+
+${includeComments ? '// Example usage' : ''}
+if (basename(__FILE__) === basename($_SERVER['PHP_SELF'])) {
+    ${includeErrorHandling ? 'try {' : ''}
+        ${includeComments ? '// Initialize client' : ''}
+        $client = new PaywareClient();
+
+        ${includeComments ? '// Execute operation' : ''}
+        $result = $client->${operation.replace('-', '_')}(${needsId ? "'example_123'" : ''}${opDef.queryParams ? (needsId ? ', []' : '[\'type\' => \'QR_CODE\']') : ''});
+
+        if ($result) {
+            echo "Operation completed successfully\\n";
+        } else {
+            echo "Operation failed\\n";
+            exit(1);
+        }
+
+    ${includeErrorHandling ? `} catch (Exception $e) {
+        echo "❌ Fatal error: " . $e->getMessage() . "\\n";
+        exit(1);
+    }` : ''}
+}
+
+?>`;
+
+    return this.wrapCodeExample(code, opDef.description, 'php', partnerType, options);
+  }
+
+  generateJavaExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+    const className = this.toPascalCase(operation);
+
+    const code = `${includeComments ? `// ${opDef.description} - Java Implementation` : ''}
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.net.URI;
+import java.util.Map;
+import java.util.HashMap;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import java.time.Duration;
+
+public class ${className}Example {
+
+    private static final String BASE_URL = System.getenv("PAYWARE_BASE_URL") != null
+        ? System.getenv("PAYWARE_BASE_URL")
+        : "https://sandbox.payware.eu/api";
+
+    private static final ObjectMapper objectMapper = new ObjectMapper();
+
+    public static void main(String[] args) {
+        ${includeComments ? `/**
+         * ${opDef.description}
+         */` : ''}
+
+        ${includeErrorHandling ? 'try {' : ''}
+            ${needsId ? 'String resourceId = "example_123";' : ''}
+
+            ${includeComments ? '// API Configuration' : ''}
+            String endpoint = "${opDef.endpoint}"${needsId ? '.replace("{id}", resourceId)' : ''};
+            String url = BASE_URL + endpoint;
+
+            ${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
+            Map<String, String> queryParams = new HashMap<>();
+            ${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
+              `queryParams.put("${key}", "${value}");`
+            ).join('\n            ')}
+
+            StringBuilder queryString = new StringBuilder();
+            queryParams.forEach((key, value) -> {
+                if (queryString.length() > 0) queryString.append("&");
+                queryString.append(key).append("=").append(value);
+            });
+            if (queryString.length() > 0) {
+                url += "?" + queryString.toString();
+            }` : ''}
+
+            ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
+            Map<String, Object> payload = new HashMap<>();
+            ${this.generateJavaPayloadMapping(opDef.sampleBody, '            ', includeComments)}
+            String requestBody = objectMapper.writeValueAsString(payload);` : `${includeComments ? '// No request body required' : ''}`}
+
+            ${includeComments ? '// Authentication' : ''}
+            String token = createJWTToken(${opDef.sampleBody ? 'requestBody' : 'null'});
+
+            ${includeComments ? '// Build HTTP request' : ''}
+            HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
+                .uri(URI.create(url))
+                .header("Authorization", "Bearer " + token)
+                .header("Content-Type", "application/json")
+                .header("Api-Version", "1")
+                .timeout(Duration.ofSeconds(30));
+
+            ${opDef.method === 'POST' ? `requestBuilder.POST(HttpRequest.BodyPublishers.ofString(${opDef.sampleBody ? 'requestBody' : '""'}));` : ''}
+            ${opDef.method === 'GET' ? 'requestBuilder.GET();' : ''}
+            ${opDef.method === 'PUT' ? `requestBuilder.PUT(HttpRequest.BodyPublishers.ofString(${opDef.sampleBody ? 'requestBody' : '""'}));` : ''}
+            ${opDef.method === 'DELETE' ? 'requestBuilder.DELETE();' : ''}
+            ${opDef.method === 'PATCH' ? `requestBuilder.method("PATCH", HttpRequest.BodyPublishers.ofString(${opDef.sampleBody ? 'requestBody' : '""'}));` : ''}
+
+            HttpRequest request = requestBuilder.build();
+
+            ${includeComments ? '// Execute request' : ''}
+            HttpClient client = HttpClient.newHttpClient();
+            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
+
+            ${includeComments ? '// Process response' : ''}
+            System.out.println("✅ " + "${opDef.description}" + " successful");
+            System.out.println("Status: " + response.statusCode());
+            System.out.println("Response: " + response.body());
+
+            ${this.getResultProcessingExample(operation, 'java', includeComments)}
+
+        ${includeErrorHandling ? `} catch (Exception e) {
+            System.err.println("❌ Request failed: " + e.getMessage());
+            e.printStackTrace();
+        }` : ''}
+    }
+
+    private static String createJWTToken(String requestBody) {
+        /**
+         * Create JWT token for payware API authentication
+         * Implementation depends on your JWT library setup
+         * See authentication examples for complete implementation
+         */
+        return "your-jwt-token";
+    }
+
+    ${this.generateJavaUtilityMethods()}
+}`;
+
+    return this.wrapCodeExample(code, opDef.description, 'java', partnerType, options);
+  }
+
+  generateCSharpExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+    const className = this.toPascalCase(operation);
+
+    const code = `${includeComments ? `// ${opDef.description} - C# Implementation` : ''}
+using System;
+using System.Net.Http;
+using System.Text;
+using System.Text.Json;
+using System.Threading.Tasks;
+using System.Collections.Generic;
+
+namespace PaywareIntegration
+{
+    public class ${className}Example
+    {
+        private static readonly HttpClient httpClient = new HttpClient();
+        private static readonly string BaseUrl = Environment.GetEnvironmentVariable("PAYWARE_BASE_URL") ?? "https://sandbox.payware.eu/api";
+
+        public static async Task Main(string[] args)
+        {
+            ${includeComments ? `/**
+             * ${opDef.description}
+             */` : ''}
+
+            ${includeErrorHandling ? 'try {' : ''}
+                ${needsId ? 'string resourceId = "example_123";' : ''}
+
+                ${includeComments ? '// API Configuration' : ''}
+                string endpoint = "${opDef.endpoint}"${needsId ? '.Replace("{id}", resourceId)' : ''};
+                string url = $"{BaseUrl}{endpoint}";
+
+                ${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
+                var queryParams = new Dictionary<string, string>
+                {
+                    ${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
+                      `["${key}"] = "${value}"`
+                    ).join(',\n                    ')}
+                };
+
+                if (queryParams.Count > 0)
+                {
+                    var queryString = string.Join("&", queryParams.Select(kv => $"{kv.Key}={kv.Value}"));
+                    url += $"?{queryString}";
+                }` : ''}
+
+                ${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
+                var payload = new
+                {
+                    ${this.generateCSharpPayload(opDef.sampleBody)}
+                };
+                string requestBody = JsonSerializer.Serialize(payload);` : `${includeComments ? '// No request body required' : ''}`}
+
+                ${includeComments ? '// Authentication' : ''}
+                string token = CreateJWTToken(${opDef.sampleBody ? 'requestBody' : 'null'});
+
+                ${includeComments ? '// Configure HTTP request' : ''}
+                var request = new HttpRequestMessage(HttpMethod.${this.toCSharpHttpMethod(opDef.method)}, url);
+                request.Headers.Add("Authorization", $"Bearer {token}");
+                request.Headers.Add("Api-Version", "1");
+
+                ${opDef.sampleBody ? 'request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");' : ''}
+
+                ${includeComments ? '// Execute request' : ''}
+                HttpResponseMessage response = await httpClient.SendAsync(request);
+                string responseContent = await response.Content.ReadAsStringAsync();
+
+                ${includeComments ? '// Process response' : ''}
+                Console.WriteLine($"✅ ${opDef.description} successful");
+                Console.WriteLine($"Status: {response.StatusCode}");
+                Console.WriteLine($"Response: {responseContent}");
+
+                ${this.getResultProcessingExample(operation, 'csharp', includeComments)}
+
+            ${includeErrorHandling ? `} catch (Exception ex) {
+                Console.WriteLine($"❌ Request failed: {ex.Message}");
+            }` : ''}
+        }
+
+        private static string CreateJWTToken(string requestBody)
+        {
+            /**
+             * Create JWT token for payware API authentication
+             * Implementation depends on your JWT library setup
+             * See authentication examples for complete implementation
+             */
+            return "your-jwt-token";
+        }
+    }
+}`;
+
+    return this.wrapCodeExample(code, opDef.description, 'csharp', partnerType, options);
+  }
+
+  generateGoExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+    const functionName = this.toCamelCase(operation);
+
+    const code = `${includeComments ? `// ${opDef.description} - Go Implementation` : ''}
+package main
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"os"
+	"strings"
+	"time"
+)
+
+${opDef.sampleBody ? `${includeComments ? `// ${this.toPascalCase(operation)}Request represents the request payload` : ''}
+type ${this.toPascalCase(operation)}Request struct {
+	${this.generateGoStructFields(opDef.sampleBody)}
+}
+
+${includeComments ? `// ${this.toPascalCase(operation)}Response represents the API response` : ''}
+type ${this.toPascalCase(operation)}Response struct {
+	Status string \`json:"status"\`
+	Data   interface{} \`json:"data"\`
+	Error  string \`json:"error,omitempty"\`
+}` : ''}
+
+func main() {
+	${includeComments ? `/**
+	 * ${opDef.description}
+	 */` : ''}
+
+	${includeErrorHandling ? 'if err := ' : ''}${functionName}Example()${includeErrorHandling ? '; err != nil {' : ''}
+	${includeErrorHandling ? `	fmt.Printf("❌ Error: %v\\n", err)
+		os.Exit(1)
+	}` : ''}
+}
+
+func ${functionName}Example() error {
+	${includeComments ? '// Configuration' : ''}
+	baseURL := os.Getenv("PAYWARE_BASE_URL")
+	if baseURL == "" {
+		baseURL = "https://sandbox.payware.eu/api"
+	}
+
+	${needsId ? 'resourceID := "example_123"' : ''}
+
+	${includeComments ? '// API Configuration' : ''}
+	endpoint := "${opDef.endpoint}"
+	${needsId ? 'endpoint = strings.Replace(endpoint, "{id}", resourceID, 1)' : ''}
+	fullURL := baseURL + endpoint
+
+	${opDef.queryParams ? `${includeComments ? '// Query parameters' : ''}
+	params := url.Values{}
+	${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
+		`params.Add("${key}", "${value}")`
+	).join('\n\t')}
+
+	if len(params) > 0 {
+		fullURL += "?" + params.Encode()
+	}` : ''}
+
+	${opDef.sampleBody ? `${includeComments ? '// Request payload' : ''}
+	payload := ${this.toPascalCase(operation)}Request{
+		${this.generateGoPayloadValues(opDef.sampleBody)}
+	}
+
+	requestBody, err := json.Marshal(payload)
+	if err != nil {
+		return fmt.Errorf("failed to marshal request: %w", err)
+	}` : `${includeComments ? '// No request body required' : ''}`}
+
+	${includeComments ? '// Authentication' : ''}
+	token := createJWTToken(${opDef.sampleBody ? 'string(requestBody)' : '""'})
+
+	${includeComments ? '// Create HTTP request' : ''}
+	${opDef.sampleBody ? 'req, err := http.NewRequest("' + opDef.method + '", fullURL, bytes.NewBuffer(requestBody))' : 'req, err := http.NewRequest("' + opDef.method + '", fullURL, nil)'}
+	if err != nil {
+		return fmt.Errorf("failed to create request: %w", err)
+	}
+
+	// Set headers
+	req.Header.Set("Authorization", "Bearer "+token)
+	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("Api-Version", "1")
+
+	${includeComments ? '// Execute request' : ''}
+	client := &http.Client{
+		Timeout: 30 * time.Second,
+	}
+
+	resp, err := client.Do(req)
+	if err != nil {
+		return fmt.Errorf("request failed: %w", err)
+	}
+	defer resp.Body.Close()
+
+	// Read response
+	responseBody, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return fmt.Errorf("failed to read response: %w", err)
+	}
+
+	${includeComments ? '// Process response' : ''}
+	fmt.Printf("✅ %s successful\\n", "${opDef.description}")
+	fmt.Printf("Status: %s\\n", resp.Status)
+	fmt.Printf("Response: %s\\n", string(responseBody))
+
+	${this.getResultProcessingExample(operation, 'go', includeComments)}
+
+	return nil
+}
+
+func createJWTToken(requestBody string) string {
+	/**
+	 * Create JWT token for payware API authentication
+	 * Implementation depends on your JWT library setup
+	 * See authentication examples for complete implementation
+	 */
+	return "your-jwt-token"
+}`;
+
+    return this.wrapCodeExample(code, opDef.description, 'go', partnerType, options);
+  }
+
+  generateRubyExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+    const methodName = this.toSnakeCase(operation);
+
+    const code = `${includeComments ? `# ${opDef.description} - Ruby Implementation` : ''}
+require 'net/http'
+require 'uri'
+require 'json'
+require 'openssl'
+require 'base64'
+
+class PaywareClient
+  def initialize
+    @base_url = ENV['PAYWARE_BASE_URL'] || 'https://sandbox.payware.eu/api'
+  end
+
+  def ${methodName}_example(${needsId ? "resource_id = 'example_123'" : ''})
+    ${includeComments ? `# ${opDef.description}` : ''}
+
+    ${includeErrorHandling ? 'begin' : ''}
+      ${includeComments ? '# API Configuration' : ''}
+      endpoint = '${opDef.endpoint}'
+      ${needsId ? "endpoint = endpoint.gsub('{id}', resource_id)" : ''}
+      uri = URI("#{@base_url}#{endpoint}")
+
+      ${opDef.queryParams ? `${includeComments ? '# Query parameters' : ''}
+      query_params = {
+        ${Object.entries(opDef.queryParams || {}).map(([key, value]) =>
+          `'${key}' => '${value}'`
+        ).join(',\n        ')}
+      }
+
+      uri.query = URI.encode_www_form(query_params) unless query_params.empty?` : ''}
+
+      ${opDef.sampleBody ? `${includeComments ? '# Request payload' : ''}
+      payload = {
+        ${this.generateRubyPayload(opDef.sampleBody)}
+      }
+      request_body = payload.to_json` : '# No request body required'}
+
+      # Authentication
+      token = create_jwt_token(${opDef.sampleBody ? 'request_body' : 'nil'})
+
+      # Create HTTP request
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true if uri.scheme == 'https'
+      http.open_timeout = 30
+      http.read_timeout = 30
+
+      request = Net::HTTP::${this.toRubyHttpMethod(opDef.method)}.new(uri)
+      request['Authorization'] = "Bearer #{token}"
+      request['Content-Type'] = 'application/json'
+      request['Api-Version'] = '1'
+
+      ${opDef.sampleBody ? 'request.body = request_body' : ''}
+
+      # Execute request
+      response = http.request(request)
+
+      # Process response
+      puts "✅ ${opDef.description} successful"
+      puts "Status: #{response.code} #{response.message}"
+      puts "Response: #{response.body}"
+
+      ${this.getResultProcessingExample(operation, 'ruby', includeComments)}
+
+      # Parse JSON response if needed
+      if response.content_type&.include?('application/json')
+        result = JSON.parse(response.body)
+        return result
+      end
+
+      response.body
+
+    ${includeErrorHandling ? `rescue StandardError => e
+      puts "❌ Request failed: #{e.message}"
+      raise e
+    end` : ''}
+  end
+
+  private
+
+  def create_jwt_token(request_body = nil)
+    # Create JWT token for payware API authentication
+    # Implementation depends on your JWT library setup
+    ${includeComments ? '# See authentication examples for complete implementation' : ''}
+    'your-jwt-token'
+  end
+end
+
+${includeComments ? '# Example usage' : ''}
+if __FILE__ == $0
+  client = PaywareClient.new
+  ${includeErrorHandling ? 'begin' : ''}
+    result = client.${methodName}_example${needsId ? "('example_123')" : '()'}
+    puts "Operation completed successfully"
+  ${includeErrorHandling ? `rescue StandardError => e
+    puts "Error: #{e.message}"
+    exit 1
+  end` : ''}
+end`;
+
+    return this.wrapCodeExample(code, opDef.description, 'ruby', partnerType, options);
+  }
+
+  generateCurlExample(operation, opDef, partnerType, options) {
+    const { includeComments, includeErrorHandling } = options;
+    const needsId = opDef.endpoint.includes('{id}');
+
+    const code = `#!/bin/bash
+${includeComments ? `# ${opDef.description} - cURL Implementation` : ''}
+
+${includeComments ? '# Configuration' : ''}
+BASE_URL="\${PAYWARE_BASE_URL:-https://sandbox.payware.eu/api}"
+${needsId ? 'RESOURCE_ID="example_123"' : ''}
+
+${includeComments ? '# API Configuration' : ''}
+ENDPOINT="${opDef.endpoint}"${needsId ? `
+ENDPOINT="\${ENDPOINT//\\{id\\}/\$RESOURCE_ID}"` : ''}
+URL="$BASE_URL$ENDPOINT"
+
+${opDef.queryParams ? `${includeComments ? '# Query parameters' : ''}
+QUERY_PARAMS="${Object.entries(opDef.queryParams || {}).map(([key, value]) => `${key}=${value}`).join('&')}"
+URL="$URL?$QUERY_PARAMS"` : ''}
+
+${opDef.sampleBody ? `${includeComments ? '# Request payload' : ''}
+read -r -d '' REQUEST_BODY << 'EOF'
+${JSON.stringify(opDef.sampleBody, null, 2)}
+EOF` : '# No request body required'}
+
+# Authentication (placeholder - implement JWT token creation)
+JWT_TOKEN="your-jwt-token"
+
+# Content-SHA256 for payware API (if request body exists)
+${opDef.sampleBody ? `CONTENT_SHA256=$(echo -n "$REQUEST_BODY" | openssl dgst -sha256 -binary | base64)` : ''}
+
+echo "🚀 Executing ${opDef.description}..."
+echo "URL: $URL"
+
+${includeErrorHandling ? '# Execute with error handling' : '# Execute request'}
+${opDef.sampleBody ? `
+curl -X ${opDef.method} "$URL" \\
+  -H "Authorization: Bearer $JWT_TOKEN" \\
+  -H "Content-Type: application/json" \\
+  -H "Api-Version: 1" \\
+  ${opDef.sampleBody ? '-H "Content-SHA256: $CONTENT_SHA256" \\' : ''}
+  ${includeErrorHandling ? '-f -s -S \\' : '-v \\'}
+  ${opDef.sampleBody ? '-d "$REQUEST_BODY"' : ''}` : `
+curl -X ${opDef.method} "$URL" \\
+  -H "Authorization: Bearer $JWT_TOKEN" \\
+  -H "Content-Type: application/json" \\
+  -H "Api-Version: 1" \\
+  ${includeErrorHandling ? '-f -s -S' : '-v'}`}
+
+${includeErrorHandling ? `
+# Check exit status
+if [ $? -eq 0 ]; then
+    echo "✅ ${opDef.description} successful"
+else
+    echo "❌ Request failed"
+    exit 1
+fi` : ''}
+
+echo "✅ Request completed"`;
+
+    return this.wrapCodeExample(code, opDef.description, 'bash', partnerType, options);
+  }
+
+
+  generateBasicAuthExample(language, partnerType, options) {
+    const { includeComments = true } = options;
+
+    const authExamples = {
+      python: `${includeComments ? '# Basic Authentication Setup - Python' : ''}
+import jwt
+import json
+import hashlib
+import base64
+from datetime import datetime, timezone
+
+def create_jwt_token(request_body=None):
+    ${includeComments ? '"""Create JWT token for payware API authentication"""' : ''}
+    partner_id = "YOUR_PARTNER_ID"
+    private_key = """-----BEGIN RSA PRIVATE KEY-----
+YOUR_PRIVATE_KEY_HERE
+-----END RSA PRIVATE KEY-----"""
+
+    # Create content SHA-256 for request body
+    content_sha256 = ""
+    if request_body:
+        content_sha256 = base64.b64encode(hashlib.sha256(request_body.encode()).digest()).decode()
+
+    # JWT payload
+    payload = {
+        "iss": partner_id,
+        "aud": "payware.eu",
+        "iat": int(datetime.now(timezone.utc).timestamp()),
+        "exp": int(datetime.now(timezone.utc).timestamp()) + 300,
+        "contentSha256": content_sha256
+    }
+
+    # Create JWT token
+    token = jwt.encode(payload, private_key, algorithm="RS256")
+    return token
+
+${includeComments ? '# Example usage' : ''}
+token = create_jwt_token()
+print(f"JWT Token: {token}")`,
+
+      nodejs: `${includeComments ? '// Basic Authentication Setup - Node.js' : ''}
+const jwt = require('jsonwebtoken');
+const crypto = require('crypto');
+
+function createJWTToken(requestBody = null) {
+    /**
+     * Create JWT token for payware API authentication
+     */
+    const partnerId = "YOUR_PARTNER_ID";
+    const privateKey = \`-----BEGIN RSA PRIVATE KEY-----
+YOUR_PRIVATE_KEY_HERE
+-----END RSA PRIVATE KEY-----\`;
+
+    ${includeComments ? '// Create content SHA-256' : ''} for request body
+    let contentSha256 = "";
+    if (requestBody) {
+        contentSha256 = crypto.createHash('sha256').update(requestBody).digest('base64');
+    }
+
+    // JWT payload
+    const payload = {
+        iss: partnerId,
+        aud: "payware.eu",
+        iat: Math.floor(Date.now() / 1000),
+        exp: Math.floor(Date.now() / 1000) + 300,
+        contentSha256: contentSha256
+    };
+
+    // Create JWT token
+    const token = jwt.sign(payload, privateKey, { algorithm: 'RS256' });
+    return token;
+}
+
+${includeComments ? '// Example usage' : ''}
+const token = createJWTToken();
+console.log(\`JWT Token: \${token}\`);`,
+
+      java: `${includeComments ? '// Basic Authentication Setup - Java' : ''}
+import io.jsonwebtoken.Jwts;
+import io.jsonwebtoken.SignatureAlgorithm;
+import java.security.PrivateKey;
+import java.security.spec.PKCS8EncodedKeySpec;
+import java.security.KeyFactory;
+import java.util.Date;
+import java.util.Map;
+import java.util.HashMap;
+import java.security.MessageDigest;
+import java.util.Base64;
+
+public class PaywareAuth {
+
+    private static String createJWTToken(String requestBody) {
+        try {
+            String partnerId = "YOUR_PARTNER_ID";
+            String privateKeyPEM = "-----BEGIN RSA PRIVATE KEY-----\\nYOUR_PRIVATE_KEY_HERE\\n-----END RSA PRIVATE KEY-----";
+
+            ${includeComments ? '// Create content SHA-256' : ''}
+            String contentSha256 = "";
+            if (requestBody != null) {
+                MessageDigest md = MessageDigest.getInstance("SHA-256");
+                byte[] digest = md.digest(requestBody.getBytes());
+                contentSha256 = Base64.getEncoder().encodeToString(digest);
+            }
+
+            // JWT payload
+            Map<String, Object> claims = new HashMap<>();
+            claims.put("iss", partnerId);
+            claims.put("aud", "payware.eu");
+            claims.put("iat", new Date().getTime() / 1000);
+            claims.put("exp", (new Date().getTime() / 1000) + 300);
+            claims.put("contentSha256", contentSha256);
+
+            // Note: You'll need to implement private key loading
+            // PrivateKey privateKey = loadPrivateKey(privateKeyPEM);
+
+            return "your-jwt-token"; // Placeholder - implement JWT creation
+
+        } catch (Exception e) {
+            throw new RuntimeException("Failed to create JWT token", e);
+        }
+    }
+
+    public static void main(String[] args) {
+        String token = createJWTToken(null);
+        System.out.println("JWT Token: " + token);
+    }
+}`,
+
+      csharp: `${includeComments ? '// Basic Authentication Setup - C#' : ''}
+using System;
+using System.Text;
+using System.Security.Cryptography;
+using Microsoft.IdentityModel.Tokens;
+using System.IdentityModel.Tokens.Jwt;
+using System.Security.Claims;
+
+public class PaywareAuth
+{
+    private static string CreateJWTToken(string requestBody = null)
+    {
+        var partnerId = "YOUR_PARTNER_ID";
+        var privateKeyPEM = @"-----BEGIN RSA PRIVATE KEY-----
+YOUR_PRIVATE_KEY_HERE
+-----END RSA PRIVATE KEY-----";
+
+        ${includeComments ? '// Create content SHA-256' : ''}
+        var contentSha256 = "";
+        if (!string.IsNullOrEmpty(requestBody))
+        {
+            using (var sha256 = SHA256.Create())
+            {
+                var hash = sha256.ComputeHash(Encoding.UTF8.GetBytes(requestBody));
+                contentSha256 = Convert.ToBase64String(hash);
+            }
+        }
+
+        // JWT payload
+        var claims = new[]
+        {
+            new Claim("iss", partnerId),
+            new Claim("aud", "payware.eu"),
+            new Claim("iat", DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(), ClaimValueTypes.Integer),
+            new Claim("exp", DateTimeOffset.UtcNow.AddMinutes(5).ToUnixTimeSeconds().ToString(), ClaimValueTypes.Integer),
+            new Claim("contentSha256", contentSha256)
+        };
+
+        // Note: You'll need to implement RSA key loading
+        // var rsa = RSA.Create();
+        // rsa.ImportFromPem(privateKeyPEM);
+        // var key = new RsaSecurityKey(rsa);
+
+        return "your-jwt-token"; // Placeholder - implement JWT creation
+    }
+
+    public static void Main(string[] args)
+    {
+        var token = CreateJWTToken();
+        Console.WriteLine($"JWT Token: {token}");
+    }
+}`,
+
+      php: `${includeComments ? '<?php // Basic Authentication Setup - PHP' : '<?php'}
+require_once 'vendor/autoload.php';
+use Firebase\\JWT\\JWT;
+use Firebase\\JWT\\Key;
+
+function createJWTToken($requestBody = null) {
+    $partnerId = "YOUR_PARTNER_ID";
+    $privateKey = "-----BEGIN RSA PRIVATE KEY-----
+YOUR_PRIVATE_KEY_HERE
+-----END RSA PRIVATE KEY-----";
+
+    ${includeComments ? '// Create content SHA-256' : ''}
+    $contentSha256 = "";
+    if ($requestBody !== null) {
+        $contentSha256 = base64_encode(hash('sha256', $requestBody, true));
+    }
+
+    // JWT payload
+    $payload = [
+        'iss' => $partnerId,
+        'aud' => 'payware.eu',
+        'iat' => time(),
+        'exp' => time() + 300,
+        'contentSha256' => $contentSha256
+    ];
+
+    // Create JWT token
+    $token = JWT::encode($payload, $privateKey, 'RS256');
+    return $token;
+}
+
+${includeComments ? '// Example usage' : ''}
+$token = createJWTToken();
+echo "JWT Token: " . $token . "\\n";
+?>`,
+
+      curl: `${includeComments ? '#!/bin/bash\n# Basic Authentication Setup - cURL' : '#!/bin/bash'}
+
+# Configuration
+PARTNER_ID="YOUR_PARTNER_ID"
+PRIVATE_KEY_FILE="path/to/private-key.pem"
+
+# Function to create JWT token (simplified)
+create_jwt_token() {
+    local request_body="\$1"
+    local content_sha256=""
+
+    if [ -n "\$request_body" ]; then
+        content_sha256=\$(echo -n "\$request_body" | openssl dgst -sha256 -binary | base64)
+    fi
+
+    echo "your-jwt-token" # Placeholder - implement JWT creation with openssl
+}
+
+${includeComments ? '# Example usage' : ''}
+JWT_TOKEN=\$(create_jwt_token)
+echo "JWT Token: \$JWT_TOKEN"`
+    };
+
+    return this.wrapCodeExample(
+      authExamples[language] || authExamples.python,
+      'Authentication Setup',
+      language,
+      partnerType,
+      options
+    );
+  }
+
+  // Helper methods for Java code generation
+  toPascalCase(str) {
+    return str.split(/[-_]/).map(word =>
+      word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+    ).join('');
+  }
+
+  generateJavaPayloadMapping(payload, indent = '            ', includeComments = true) {
+    if (!payload) return '';
+
+    const generateMapping = (obj, path = '') => {
+      let result = [];
+      for (const [key, value] of Object.entries(obj)) {
+        const currentPath = path ? `${path}.${key}` : key;
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+          result.push(`${indent}Map<String, Object> ${key} = new HashMap<>();`);
+          result.push(...generateMapping(value, key).map(line => line.replace(/^            /, indent)));
+          result.push(`${indent}payload.put("${key}", ${key});`);
+        } else if (Array.isArray(value)) {
+          if (includeComments) {
+            result.push(`${indent}// Note: Array handling needed for ${key}`);
+          }
+          result.push(`${indent}payload.put("${key}", Arrays.asList(${JSON.stringify(value)}));`);
+        } else {
+          const javaValue = typeof value === 'string' ? `"${value}"` : value;
+          if (path) {
+            result.push(`${indent}${path}.put("${key}", ${javaValue});`);
+          } else {
+            result.push(`${indent}payload.put("${key}", ${javaValue});`);
+          }
+        }
+      }
+      return result;
+    };
+
+    return generateMapping(payload).join('\n');
+  }
+
+  generateJavaUtilityMethods() {
+    return `
+    // Utility methods for handling responses and common operations
+    // Add additional helper methods as needed for your specific implementation`;
+  }
+
+  getResultProcessingExample(operation, language) {
+    const examples = {
+      create_transaction: {
+        java: 'System.out.println("Transaction ID: " + response.body());',
+        nodejs: 'console.log("Transaction ID:", result.transactionId);',
+        python: 'print(f"Transaction ID: {result[\'transactionId\']}")',
+        csharp: 'Console.WriteLine($"Transaction ID: {responseContent}");',
+        go: 'fmt.Printf("Transaction ID: %s\\n", responseBody)',
+        ruby: 'puts "Transaction ID: #{response.body}"',
+        php: 'echo "Transaction ID: " . $result[\'transactionId\'] . "\\n";'
+      },
+      get_transaction_link: {
+        java: 'System.out.println("Deep link URL: " + response.body());',
+        nodejs: 'console.log("Deep link URL:", result.deepLinkUrl);',
+        python: 'print(f"Deep link URL: {result[\'deepLinkUrl\']}")',
+        csharp: 'Console.WriteLine($"Deep link URL: {responseContent}");',
+        go: 'fmt.Printf("Deep link URL: %s\\n", responseBody)',
+        ruby: 'puts "Deep link URL: #{result[\'deepLinkUrl\']}"',
+        php: 'echo "Deep link URL: " . $result[\'deepLinkUrl\'] . "\\n";'
+      }
+    };
+
+    return examples[operation]?.[language] || '// Process result as needed';
+  }
+
+  // C# helper methods
+  toCSharpHttpMethod(method) {
+    const methodMap = {
+      'GET': 'Get',
+      'POST': 'Post',
+      'PUT': 'Put',
+      'DELETE': 'Delete',
+      'PATCH': 'Patch'
+    };
+    return methodMap[method] || 'Post';
+  }
+
+  generateCSharpPayload(payload, indent = '                    ') {
+    if (!payload) return '';
+
+    const generateMapping = (obj, depth = 0) => {
+      let result = [];
+      for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+          result.push(`${key} = new {`);
+          result.push(...generateMapping(value, depth + 1).map(line => `    ${line}`));
+          result.push('}');
+        } else if (Array.isArray(value)) {
+          result.push(`${key} = new[] { ${value.map(v => typeof v === 'string' ? `"${v}"` : v).join(', ')} }`);
+        } else {
+          const csharpValue = typeof value === 'string' ? `"${value}"` : value;
+          result.push(`${key} = ${csharpValue}`);
+        }
+      }
+      return result;
+    };
+
+    return generateMapping(payload).join(',\n' + indent);
+  }
+
+  // Go helper methods
+  toCamelCase(str) {
+    return str.split(/[-_]/).map((word, index) =>
+      index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+    ).join('');
+  }
+
+  generateGoStructFields(payload, indent = '\t') {
+    if (!payload) return '';
+
+    const generateFields = (obj, depth = 0) => {
+      let result = [];
+      for (const [key, value] of Object.entries(obj)) {
+        const fieldName = this.toPascalCase(key);
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+          result.push(`${fieldName} struct {`);
+          result.push(...generateFields(value, depth + 1).map(line => `\t${line}`));
+          result.push(`} \`json:"${key}"\``);
+        } else if (Array.isArray(value)) {
+          const elemType = value.length > 0 ? (typeof value[0] === 'string' ? 'string' : 'interface{}') : 'interface{}';
+          result.push(`${fieldName} []${elemType} \`json:"${key}"\``);
+        } else {
+          const goType = typeof value === 'string' ? 'string' : 'interface{}';
+          result.push(`${fieldName} ${goType} \`json:"${key}"\``);
+        }
+      }
+      return result;
+    };
+
+    return generateFields(payload).join('\n' + indent);
+  }
+
+  generateGoPayloadValues(payload, indent = '\t\t') {
+    if (!payload) return '';
+
+    const generateValues = (obj, depth = 0) => {
+      let result = [];
+      for (const [key, value] of Object.entries(obj)) {
+        const fieldName = this.toPascalCase(key);
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+          result.push(`${fieldName}: ${this.toPascalCase(key)}Request{`);
+          result.push(...generateValues(value, depth + 1).map(line => `\t${line}`));
+          result.push('},');
+        } else if (Array.isArray(value)) {
+          const arrayValues = value.map(v => typeof v === 'string' ? `"${v}"` : v).join(', ');
+          result.push(`${fieldName}: []interface{}{${arrayValues}},`);
+        } else {
+          const goValue = typeof value === 'string' ? `"${value}"` : value;
+          result.push(`${fieldName}: ${goValue},`);
+        }
+      }
+      return result;
+    };
+
+    return generateValues(payload).join('\n' + indent);
+  }
+
+  // Ruby helper methods
+  toSnakeCase(str) {
+    return str.split(/[-_]/).map(word => word.toLowerCase()).join('_');
+  }
+
+  toRubyHttpMethod(method) {
+    const methodMap = {
+      'GET': 'Get',
+      'POST': 'Post',
+      'PUT': 'Put',
+      'DELETE': 'Delete',
+      'PATCH': 'Patch'
+    };
+    return methodMap[method] || 'Post';
+  }
+
+  generateRubyPayload(payload, indent = '        ') {
+    if (!payload) return '';
+
+    const generateValues = (obj, depth = 0) => {
+      let result = [];
+      for (const [key, value] of Object.entries(obj)) {
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+          result.push(`'${key}' => {`);
+          result.push(...generateValues(value, depth + 1).map(line => `  ${line}`));
+          result.push('}');
+        } else if (Array.isArray(value)) {
+          const arrayValues = value.map(v => typeof v === 'string' ? `'${v}'` : v).join(', ');
+          result.push(`'${key}' => [${arrayValues}]`);
+        } else {
+          const rubyValue = typeof value === 'string' ? `'${value}'` : value;
+          result.push(`'${key}' => ${rubyValue}`);
+        }
+      }
+      return result;
+    };
+
+    return generateValues(payload).join(',\n' + indent);
+  }
+
+  // PHP helper methods
+  generatePHPArray(payload, baseIndent = '        ') {
+    if (!payload) return '[]';
+
+    const formatValue = (value, depth = 0) => {
+      const indent = baseIndent + '    '.repeat(depth);
+
+      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        const entries = Object.entries(value).map(([k, v]) => {
+          return `${indent}    '${k}' => ${formatValue(v, depth + 1)}`;
+        });
+        return `[\n${entries.join(',\n')}\n${indent}]`;
+      } else if (Array.isArray(value)) {
+        const arrayValues = value.map(v => typeof v === 'string' ? `'${v}'` : v).join(', ');
+        return `[${arrayValues}]`;
+      } else {
+        return typeof value === 'string' ? `'${value}'` : value;
+      }
+    };
+
+    const entries = Object.entries(payload).map(([key, value]) => {
+      return `${baseIndent}    '${key}' => ${formatValue(value)}`;
+    });
+
+    return `[\n${entries.join(',\n')}\n${baseIndent}]`;
+  }
+
+  // Framework-specific generators (basic implementations)
+  generateDjangoExample(operation, partnerType, options) {
+    return `# Django Framework Implementation for ${operation}
+# views.py
+from django.http import JsonResponse
+from rest_framework.views import APIView
+
+class PaywareAPIView(APIView):
+    def post(self, request):
+        # Implementation for ${operation}
+        return JsonResponse({'status': 'success'})`;
+  }
+
+  generateExpressExample(operation, partnerType, options) {
+    return `// Express.js Framework Implementation for ${operation}
+const express = require('express');
+const router = express.Router();
+
+router.post('/${operation}', async (req, res) => {
+    // Implementation for ${operation}
+    res.json({ status: 'success' });
+});
+
+module.exports = router;`;
+  }
+
+  generateLaravelExample(operation, partnerType, options) {
+    return `<?php
+// Laravel Framework Implementation for ${operation}
+namespace App\\Http\\Controllers;
+
+use Illuminate\\Http\\Request;
+
+class PaywareController extends Controller
+{
+    public function ${operation}(Request $request)
+    {
+        // Implementation for ${operation}
+        return response()->json(['status' => 'success']);
+    }
+}
+?>`;
+  }
+}
+
+// Export the advanced generator
+export const advancedCodeGenerator = new AdvancedCodeGenerator();
+
+/**
+ * Main code generation tool
+ */
+export const generateCodeExampleTool = {
+  name: 'payware_generate_code_example',
+  description: 'Generate production-ready payware API integration code examples with authentication, error handling, and environment configuration for any operation across 16 supported operations and 6 programming languages.',
+
+  inputSchema: {
+    type: 'object',
+    properties: {
+      operation: {
+        type: 'string',
+        description: 'payware API operation to generate code for. Categories: AUTHENTICATION (authentication), TRANSACTIONS (create_transaction, get_transaction_status, process_transaction, cancel_transaction, get_transaction_history), PRODUCTS - merchant/ISV only (create_product, get_product, list_products, update_product, delete_product), OAUTH2 - ISV only (obtain_token, get_token_info), REPORTS (generate_report, get_report_status, export_report), DEEP LINKS (get_transaction_link, get_product_link), AUDIO/SOUNDBITES - merchant/ISV only (register_audio, get_audios, get_audio, update_audio, delete_audio)',
+        enum: [
+          'authentication',
+          'create_transaction',
+          'get_transaction_status',
+          'process_transaction',
+          'cancel_transaction',
+          'get_transaction_history',
+          'create_product',
+          'get_product',
+          'list_products',
+          'update_product',
+          'delete_product',
+          'obtain_token',
+          'get_token_info',
+          'generate_report',
+          'get_report_status',
+          'export_report',
+          'get_transaction_link',
+          'get_product_link',
+          'register_audio',
+          'get_audios',
+          'get_audio',
+          'update_audio',
+          'delete_audio'
+        ]
+      },
+      language: {
+        type: 'string',
+        description: 'Programming language for generated code examples. Options: python (requests, JWT), nodejs (axios, async/await), php (cURL, PSR standards), java (HTTP client, Jackson), csharp (HttpClient, System.Text.Json), curl (command-line). All include authentication, environment configuration, and error handling.',
+        enum: ['python', 'nodejs', 'php', 'java', 'csharp', 'curl']
+      },
+      partner_type: {
+        type: 'string',
+        description: 'payware partner type determines available operations. merchant: transactions, products, reports, deep links. isv: all merchant operations plus OAuth2 token management for multiple merchants. payment_institution: transactions, advanced settlement features.',
+        enum: ['merchant', 'isv', 'payment_institution']
+      },
+      include_comments: {
+        type: 'boolean',
+        description: 'Include detailed code comments and documentation in generated code. true (default): full documentation with inline comments, function docs, parameter explanations, usage examples. false: clean minimal code without comments for experienced developers.'
+      },
+      include_error_handling: {
+        type: 'boolean',
+        description: 'Include comprehensive error handling and validation in generated code. true (default): robust error handling with try/catch blocks, HTTP status validation, network error handling, detailed error messages. false: minimal error handling for streamlined code.'
+      }
+    },
+    required: ['operation'],
+    additionalProperties: false
+  },
+
+  async handler(args) {
+    try {
+      // Convert snake_case to camelCase for options
+      const options = {
+        includeComments: args.include_comments !== false, // Default true
+        includeErrorHandling: args.include_error_handling !== false, // Default true
+        framework: args.framework
+      };
+
+      const result = advancedCodeGenerator.generateExample(
+        args.operation,
+        args.language || 'python',
+        args.partner_type || 'merchant',
+        options
+      );
+
+      // If comments are disabled, return just the code in proper MCP format
+      if (options.includeComments === false) {
+        return {
+          content: [{
+            type: 'text',
+            text: result
+          }]
+        };
+      }
+
+      // Add additional documentation only when comments are enabled
+      const stats = advancedCodeGenerator.getImplementationStats();
+      const availableOps = advancedCodeGenerator.getAvailableOperations(args.partner_type || 'merchant');
+
+      const response = `${result}
+
+## Implementation Statistics
+
+- **Languages Supported**: ${stats.languages}
+- **Total Operations**: ${stats.totalOperations}
+- **Coverage**: ${stats.coverage}%
+
+## Available Operations for ${args.partner_type || 'merchant'}
+
+${Object.entries(availableOps)
+  .map(([category, ops]) => `### ${category}\n${ops.map(op => `- ${op}`).join('\n')}`)
+  .join('\n\n')}
+
+## Supported Languages
+
+${advancedCodeGenerator.supportedLanguages.join(', ')}
+
+
+## Next Steps
+
+1. Copy the generated code to your project
+2. Install required dependencies
+3. Configure environment variables
+4. Set up payware private keys
+5. Test in sandbox mode
+
+Use different parameters to explore all available options!
+`;
+
+      return {
+        content: [{
+          type: 'text',
+          text: response
+        }]
+      };
+
+    } catch (error) {
+      return {
+        content: [{
+          type: 'text',
+          text: `❌ Error generating code example: ${error.message}\n\nPlease check your parameters and try again.`
+        }]
+      };
+    }
+  }
+};
+
+/**
+ * Documentation generation tool
+ */
+export const generateDocumentationTool = {
+  name: 'payware_generate_documentation',
+  description: 'Generate comprehensive documentation for payware API integration with quick start instructions, authentication flows, operation examples, error handling patterns, and language-specific integration guides.',
+
+  inputSchema: {
+    type: 'object',
+    properties: {
+      language: {
+        type: 'string',
+        description: 'Programming language to focus documentation on. Options: python (requests, virtual env), nodejs (npm, async/await), php (Composer, PSR), java (Maven/Gradle, Spring Boot), csharp (NuGet, ASP.NET Core), curl (command-line). Includes language-specific setup and patterns.',
+        enum: ['python', 'nodejs', 'php', 'java', 'csharp', 'curl']
+      },
+      partner_type: {
+        type: 'string',
+        description: 'Partner type determines documentation scope. merchant: transaction processing, product management, basic reporting. isv: all merchant features plus OAuth2 for multi-merchant management. payment_institution: transactions, advanced settlement.',
+        enum: ['merchant', 'isv', 'payment_institution']
+      }
+    },
+    additionalProperties: false
+  },
+
+  async handler(args) {
+    try {
+      const { language = 'python', partner_type = 'merchant' } = args;
+      const stats = advancedCodeGenerator.getImplementationStats();
+      const availableOps = advancedCodeGenerator.getAvailableOperations(partner_type);
+
+      const documentation = `# payware ${language.toUpperCase()} Integration Documentation
+
+Complete integration guide for ${partner_type} partners.
+
+## Quick Start
+
+1. **Authentication Setup**: Use \`payware_generate_code_example\` with \`operation="authentication"\`
+2. **Environment Config**: Set up .env file with credentials
+3. **API Integration**: Use operation-specific examples
+4. **Testing**: Start with sandbox mode
+
+## Implementation Overview
+
+- **Languages**: ${stats.languages} supported (${advancedCodeGenerator.supportedLanguages.join(', ')})
+- **Frameworks**: ${stats.frameworks} supported
+- **Operations**: ${stats.totalOperations} available operations
+- **Coverage**: ${stats.coverage}% complete implementation
+
+## Available Operations
+
+${Object.entries(availableOps)
+  .map(([category, ops]) => `### ${category.charAt(0).toUpperCase() + category.slice(1)}\n${ops.map(op => `- \`${op}\``).join('\n')}`)
+  .join('\n\n')}
+
+## Code Generation Examples
+
+\`\`\`javascript
+// Basic transaction
+payware_generate_code_example({
+  operation: "create_transaction",
+  language: "${language}",
+  partner_type: "${partner_type}"
+})
+
+// Framework-specific
+payware_generate_code_example({
+  operation: "create_transaction",
+  language: "${language}",
+  framework: "django", // or express, laravel, etc.
+  partner_type: "${partner_type}"
+})
+
+// Transaction creation
+payware_generate_code_example({
+  operation: "create_transaction",
+  language: "${language}",
+  partner_type: "${partner_type}"
+})
+\`\`\`
+
+## Framework Support for ${language}
+
+${advancedCodeGenerator.supportedFrameworks
+  .filter(f => {
+    if (language === 'python') return ['django', 'fastapi', 'flask'].includes(f);
+    if (language === 'nodejs') return ['express', 'nestjs', 'koa'].includes(f);
+    if (language === 'php') return ['laravel', 'symfony'].includes(f);
+    if (language === 'java') return ['spring', 'springboot'].includes(f);
+    if (language === 'csharp') return ['aspnet', 'blazor'].includes(f);
+    if (language === 'go') return ['gin', 'fiber'].includes(f);
+    if (language === 'ruby') return ['rails', 'sinatra'].includes(f);
+    return false;
+  })
+  .map(f => `- **${f}**: Framework-specific implementations available`)
+  .join('\n') || '- Standard implementations available'}
+
+
+## Best Practices
+
+1. **Security**: Always use sandbox mode for testing
+2. **Authentication**: Implement proper JWT token handling
+3. **Error Handling**: Include comprehensive error handling
+4. **Testing**: Use the \`include_tests: true\` option for unit tests
+5. **Monitoring**: Implement proper logging and monitoring
+
+## Support
+
+For specific implementations, use the code generation tool with your exact requirements:
+
+\`\`\`
+payware_generate_code_example(operation, language, partner_type, options)
+\`\`\`
+
+All ${stats.totalOperations} operations are fully implemented across all ${stats.languages} supported languages.
+`;
+
+      return {
+        content: [{
+          type: 'text',
+          text: documentation
+        }]
+      };
+
+    } catch (error) {
+      return {
+        content: [{
+          type: 'text',
+          text: `❌ Error generating documentation: ${error.message}`
+        }]
+      };
+    }
+  }
 };