Przelewy24 Bundle Laravel Package

Product Decisions This Supports

• Expanding payment options for Polish markets: Enables seamless integration with Przelewy24, a leading Polish payment gateway, reducing reliance on global providers (e.g., Stripe) for local compliance and user trust.
• Accelerating feature delivery: Eliminates custom API integration effort for Przelewy24, allowing the team to focus on core business logic (e.g., order fulfillment, fraud detection).
• Roadmap alignment: Supports a build vs. buy decision for payment infrastructure, favoring "buy" to avoid maintenance overhead of a bespoke solution.
• Use cases:
  • E-commerce platforms targeting Poland (e.g., SaaS subscriptions, digital goods).
  • Marketplaces requiring multi-currency support (PLN + optional foreign currencies via Przelewy24’s API).
  • Compliance with Polish Payment Services Act (Ustawa o usługach płatniczych) without legal/tech debt.

When to Consider This Package

• Adopt if:

  • Your product serves Polish customers and needs Przelewy24 integration.
  • You’re using Symfony 3.3+ (or can upgrade) and prefer a pre-built solution over raw API calls.
  • Your team lacks bandwidth to build/maintain a custom Przelewy24 adapter.
  • You need event-driven workflows (e.g., triggering order fulfillment on payment success).

• Look elsewhere if:

  • You require Symfony 4.4+ (package is unmaintained; last release in 2021).
  • Your stack is non-Symfony (e.g., Laravel, Node.js) or uses a different framework.
  • You need advanced features (e.g., 3D Secure 2.0, recurring payments) not covered by the bundle’s scope.
  • Security/compliance risks: The package is archived with no active maintenance (MIT license mitigates this but isn’t ideal for production-critical systems).
  • You prefer modern alternatives like Przelewy24’s official PHP SDK or a more actively maintained bundle.

How to Pitch It (Stakeholders)

For Executives:

"This bundle lets us add Przelewy24—Poland’s most trusted payment gateway—to our platform in days, not months*. It’s a drop-in solution for Symfony apps, reducing dev effort while expanding our reach to Polish customers. The event-driven architecture ensures seamless integration with our order system, and the sandbox mode lets us test thoroughly before launch. Given the low risk (MIT license) and minimal maintenance (archived but stable), it’s a cost-effective way to meet local payment demands without overloading our team."*

For Engineering:

*"The Allset Przelewy24 Bundle provides a thin, Symfony-native wrapper around Przelewy24’s API, handling:

• Payment form generation (via ProcessFactory).
• Webhook events (e.g., payment_success) for order processing.
• Sandbox testing (critical for local dev).
• Config-driven setup (merchant ID, CRC key, sandbox mode).

Pros:

• No need to reinvent the wheel for Przelewy24’s quirks (e.g., CRC validation, session IDs).
• Events integrate cleanly with Symfony’s service container.
• Lightweight (~500 LOC; easy to audit).

Cons:

• Archived (last update 2021); fork or extend if critical bugs arise.
• Symfony-only (not portable to other stacks).
• Limited docs (but code is straightforward).

Recommendation: Use for MVP, then evaluate upgrading to Przelewy24’s official SDK or a maintained fork if long-term support is needed."*