- How do I install and set up baks-dev/megamarket-orders in Laravel?
- Run `composer require baks-dev/megamarket baks-dev/megamarket-orders` to install. The package auto-runs setup commands for profile types, payments, and deliveries via `php artisan baks:users-profile-type:megamarket`, `php artisan baks:payment:megamarket`, and `php artisan baks:delivery:megamarket`. Ensure PHP 8.4+ is used, as the package enforces this requirement.
- Where should I store Megamarket API credentials (client ID, secret, etc.)?
- The package does not explicitly document credential storage, but Laravel best practices suggest using environment variables (`.env` file). Check if the `baks-dev/megamarket` package provides a config file or service provider for credential management, as this package relies on it.
- Does this package support sandbox/testing mode for Megamarket API calls?
- The README does not mention sandbox support, but the package likely inherits this from `baks-dev/megamarket`. Check its documentation for API configuration options, as this package assumes the parent package handles authentication and environment-specific endpoints.
- Can I extend or override existing payment/delivery methods without modifying the package source?
- The package lacks documented hooks or events for customization, so extending payment/delivery logic may require overriding service providers or modifying the package’s source directly. Review the `baks-dev/megamarket` package for extensibility features, as this package builds on top of it.
- How does the package handle failed Megamarket webhook deliveries?
- The package does not specify webhook retry logic or dead-letter queues. Failed webhooks may require manual intervention or custom error handling. Ensure your Laravel application logs webhook failures at `/megamarket/order/new` and `/megamarket/order/cancel` endpoints for debugging.
- Will this package conflict with my existing Eloquent order model or database schema?
- The package includes database migrations to add Megamarket-specific fields (e.g., `lot_id`, `delivery_type`). Run `php artisan doctrine:migrations:diff` and `php artisan doctrine:migrations:migrate` to apply changes, but conflicts may arise if your existing order model has overlapping relationships or constraints.
- Is the package compatible with Laravel 10+ or only PHP 8.4+?
- The package requires PHP 8.4+ but does not explicitly state Laravel version compatibility. Test thoroughly in your Laravel 10+ environment, as some features (e.g., Doctrine migrations) may behave differently across Laravel versions. Check the `baks-dev/megamarket` package for Laravel-specific dependencies.
- Are there any rate limits or throttling mechanisms for Megamarket API calls?
- The package does not document rate limits or throttling policies. Megamarket’s API may impose its own limits, so implement retry logic with exponential backoff in your Laravel application or middleware to handle throttling gracefully.
- Does this package support multi-language or global e-commerce beyond Russian/CIS markets?
- The package is optimized for Megamarket’s Russian/CIS-specific workflows, including currency, address formats, and localization. Extending it for global markets may require customizations, such as modifying payment/delivery logic or adding translation layers.
- What alternatives exist if I need a more flexible or multi-marketplace Laravel integration?
- For broader marketplace support, consider packages like `spatie/laravel-marketplace` or `webkul/marketplace`. These offer multi-vendor and multi-marketplace integrations but may lack Megamarket-specific optimizations. Evaluate trade-offs between niche specialization (this package) and flexibility (alternatives).