Svea Laravel Package

Product Decisions This Supports

• Feature Expansion: Enables seamless integration of Svea Checkout, Payment Admin, and Webhook Subscriptions into a Laravel-based e-commerce platform, reducing development time for payment flows (checkout, subscriptions, and post-payment operations).
• Roadmap Alignment: Supports a phased rollout of payment features (e.g., starting with checkout, then adding subscriptions and webhooks) without overhauling existing infrastructure.
• Build vs. Buy: Eliminates the need to build a custom payment SDK, reducing technical debt and maintenance overhead. The package’s Laravel-specific optimizations (facades, Artisan commands, testing tools) justify its adoption over a generic PHP SDK.
• Use Cases:
  • B2C E-commerce: Streamline checkout flows with Svea’s localized payment methods (Sweden, Norway, Denmark, Finland).
  • Recurring Payments: Manage subscriptions via Svea’s Admin API (e.g., auto-deliveries, cancellations, credits).
  • Webhook-Driven Workflows: Decouple payment events (e.g., CheckoutOrder.Delivered) from business logic using Laravel’s event system.
  • Testing & Debugging: Leverage Svea::fake() for unit/feature tests, mimicking Svea’s API responses without hitting live endpoints.

When to Consider This Package

• Adopt if:
  • Your product uses Svea Checkout as a primary payment provider and operates in Sweden, Norway, Denmark, or Finland.
  • You need Laravel-native integration (facades, Artisan commands, event dispatching) to reduce boilerplate.
  • Your team prioritizes developer experience (fluent API, testing tools, typed exceptions) over minimalism.
  • You require webhook subscriptions and inbound verification for async payment events.
• Look elsewhere if:
  • You’re using a non-Laravel framework (the package’s Laravel-specific features may not fit).
  • Your payment stack is multi-provider and requires a vendor-agnostic SDK (e.g., Stripe + Svea).
  • You need real-time payment processing (Svea’s async model may introduce latency).
  • Your team lacks PHP/Laravel expertise to leverage the package’s advanced features (e.g., Svea::fake()).

How to Pitch It (Stakeholders)

For Executives: "This package lets us integrate Svea’s payment APIs into our Laravel app with minimal dev effort. It handles checkout, subscriptions, and webhooks—key for scaling our Nordic markets—while cutting maintenance costs. The built-in testing tools and Laravel integrations (like Artisan commands) speed up development and reduce bugs. We avoid reinventing the wheel and can focus on core features."

For Engineering: *"The SDK provides a fluent, typed API for Svea’s Checkout, Admin, and Webhook APIs, with Laravel-specific optimizations:

• Checkout: Create orders with minor-unit precision (e.g., 29900 = 299.00 SEK) and localized payment flows.
• Admin: Manage payments (deliver, cancel, credit) with idempotency keys for safe retries.
• Webhooks: Subscribe to events (e.g., CheckoutOrder.Delivered) and verify signatures automatically.
• Testing: Svea::fake() mimics API responses for unit tests—no mocking boilerplate.
• Observability: Works with Wiretap to log all API calls/responses for debugging. It’s production-ready (MIT license, PHPStan level 6) and supports our PHP 8.2+ stack."