Finam Sdk Laravel Laravel Package

Product Decisions This Supports

• Evaluating a Laravel/PHP integration with Finam for brokerage, market-data, or account-related workflows where transient HTTP failures can disrupt user-facing operations.
• Deciding whether to build in-house retry/backoff logic around Finam API calls or adopt a package that now handles 429/503 responses, Retry-After, and configurable exponential backoff.
• Roadmap planning for production hardening: v1.2.0 improves resilience without breaking existing fixed-delay behavior, so teams can adopt retry improvements incrementally.
• Prioritizing operational safety over custom middleware: configurable backoff reduces thundering-herd risk against Finam endpoints and avoids one-off retry implementations in each service.
• Build-vs-buy: strengthens the case for using the package when Finam integration is not a core differentiator and the team values maintained retry semantics plus PHPUnit/PHPStan/Psalm checks.

When to Consider This Package

• You are building a Laravel or PHP application that integrates with Finam APIs and needs resilient handling of transient upstream failures.
• You want configurable retry behavior for 429/503 responses, including respect for Retry-After, rather than hand-rolled Guzzle retry configuration.
• You need backward-compatible defaults: retry_multiplier defaults to 1.0, preserving existing fixed-delay behavior while allowing exponential backoff where appropriate.
• You value signs of maintainability and quality gates: 107 PHPUnit tests plus PHPStan and Psalm are passing locally for this release.
• Look elsewhere if you do not use Finam, need a general-purpose HTTP retry layer across many providers, require guaranteed vendor support/SLA, or need retry behavior beyond what this package exposes.

How to Pitch It (Stakeholders)

Executives: v1.2.0 makes the Finam integration more production-ready by handling temporary API failures more gracefully. It adds configurable exponential backoff and respects server-provided retry timing, reducing failed user actions and operational noise without forced migration.

Engineering: this is a backward-compatible reliability release. FinamClient now retries transient HTTP responses such as 429 and 503, not only Guzzle transport errors, and honors Retry-After when present. The new retry_multiplier HTTP config enables exponential backoff while defaulting to existing fixed-delay behavior. Local PHPUnit, PHPStan, and Psalm checks remain green, so adoption risk is low and rollout can be config-driven.