Download the PHP package isa-sdk/sdk without Composer

sah/sdk (PHP)

Unified PHP SDK for the Best Plan Pro API — powered by the ZyINS engine. One Composer package, three product namespaces: zyins (underwriting), rapidsign (envelope and document workflows), proxy (/v1/call Algosure-HMAC bridge).

The canonical surface across SDK languages is the unified JS package at packages/ts/src/ (entry). This PHP package mirrors that surface in idiomatic PHP 8.2 — readonly classes, constructor promotion, named-args, PSR-18 transport.

Install

(Private Packagist; auto-update is wired to this repository. Tag pattern is sdk/vX.Y.Z on isa-platform — one tag, one publish per language. The flat sdk-php mirror is tagged vX.Y.Z for Packagist webhook discovery.)

Quick start — bearer mode

Factories

withKeycode is the canonical factory for agent-tool (BPP) integrations. withLicense is a deprecated alias that will be removed in a future major version. Use withKeycode in new code.

Missing env vars raise Isa\Sdk\Zyins\Exception\IsaConfigException with the exact variable name in the message.

Your first call

Per-surface API versions

The ISA API is a federation of independently versioned surfaces. Every SDK release exports a frozen BundledApiVersions::MAP recording which /vN each surface targets:

Pin individual surfaces with a per-surface apiVersion map. There is no default key and no string shorthand — resolution is $apiVersion[$surface] ?? BundledApiVersions::MAP[$surface]:

The release that retargets prequalify / quote / datasets / reference to v3 will bump those entries. See SDK syntax proposal §2.7.

Reference data — ->match()

The unversioned $isa->zyins->reference namespace canonicalizes free-text medication and condition input. Unknown text never rejects — it returns a structured concept with isKnown === false, so the final canonicalization fires server-side at /vN/prequalify:

Sort::MostCommonFirst and Sort::Alphabetical are the two supported orderings.

Case storage — bring your own

$isa->zyins->cases->* routes through a CaseStorage adapter. The default is the zero-knowledge store — ISA's servers only hold ciphertext and an opaque ID. To plug a carrier-controlled store, pass your adapter at construction:

See cases guide for the full bring-your-own pattern.

Product namespaces

Each sub-namespace's services preserve the same request envelope and error funnel:

• IsaIdempotencyConflictException with getKey(), getFirstSeenAt() — retryable conflict on Idempotency-Key.
• Envelope (readonly): requestId, idempotencyKey, retryAttempts.
• withRawResponse() variants — return [$data, $rawResponse] for callers that need the underlying PSR-7 response.
• Cursor escape hatch on list iterators — the iterator wrapper exposes cursor() so callers can resume pagination across processes.
• Stderr-only debug logging via fwrite(STDERR, ...) when ISA_LOG=debug, guarded by a PSR-3 logger so callers can route elsewhere.

See MIGRATION.md for the move from the per-product packages (sah/sdk-zyins, sah/sdk-rapidsign, sah/sdk-proxy, isa-sdk/core-transport).

Development

Licenses and Ready

The PHP SDK exposes the public BPP license-lifecycle surface and the platform readiness probe on every ZyInsClient:

/v1/licenses/check and /v1/licenses/deactivate are public; /ready is the unauthenticated load-balancer probe.