FAQ

What is Paymery?

Paymery is a Laravel 12 billing and invoicing system that helps you manage plans, payments (Stripe or manual), invoices (PDF), coupons, and admin workflows from a clean dashboard. It is designed to be production-ready and customizable, so you can adapt it to your project requirements.

Do I need Stripe to use Paymery?

No. Stripe is optional. You can run Paymery using Manual Billing without configuring Stripe. If you enable Stripe (Cashier), you must configure API keys and webhooks. See Stripe Configuration.

Why do I need Stripe Price IDs for plans?

When Stripe billing is enabled, each plan must be mapped to a Stripe recurring price. You create the product/price in Stripe, then copy the Price ID into the plan configuration. See Plans and Stripe Configuration.

Does Paymery support multiple currencies?

Yes. Paymery supports multi-currency, but prices are defined manually per currency. There is no automatic currency conversion. If you switch the site currency, you should define plan prices and review fixed coupons accordingly. See Multi-Currency.

How do fixed coupons and plan prices work?

Fixed values are entered using the smallest currency unit (example: in USD, 500 means $5.00). Percent coupons are currency-independent, while fixed discounts depend on the active site currency. See Coupons and Plans.

Can I translate the system and add a new language?

Yes. Paymery includes an i18n system for both the public site and admin panel, with RTL/LTR support. You can select the default language from Settings, and optionally enable the language switcher for visitors. You can also add new locales by creating a new folder under resources/lang and enabling it in config/i18n.php. See Localization (i18n).

Do I need Cron & Queue in production?

Yes. For production usage, cron and queue processing are recommended so background tasks (emails, notifications, scheduled jobs) work reliably. On shared hosting, this is typically configured using cron jobs. On VPS, a process manager like Supervisor is recommended. See Cron & Queue.

Emails are not being delivered. What should I check?

Confirm your SMTP configuration in the .env file and send a test email from the Email Templates section. Also verify server connectivity and mail provider credentials. See Post Installation and Email Templates.

Where do manual payments appear and how do I approve them?

Manual payments appear in the admin panel under Manual Requests. Admins can review details and payment proof (screenshot), then approve or reject the request. See Manual Payment Requests.

How can I verify my installation is configured correctly?

Use the System Health page in the admin panel. It checks environment, database/cache, queue, mail, storage, and billing readiness. See System Health.

Can I restrict admin/staff access to specific sections?

Yes. Paymery supports Roles & Permissions so you can create staff roles (Billing, Support, etc.) and control what each role can access. See Roles & Permissions.

Shared hosting vs VPS: which one should I use?

Both are supported. Shared hosting may require an .htaccess redirect to serve the app from the public folder and cron-based queue processing. VPS offers better control, performance, and the ability to run Supervisor for queue workers. See Installation and Cron & Queue.

Will the app stop working if the license server is temporarily unavailable?

Licensing is used during installation/activation only. After successful activation and installation, the application runs normally on your server. If you need to re-run the installer in the future, ensure your server can reach the license service.