Official SDKs

Zayono publishes maintained SDKs for the 4 most-used languages in payment integration. They wrap authentication, automatic retries, pagination, webhook signature verification, and expose a typed API idiomatic to the host language.

🐘

PHP SDK

Composer · PHP 8.1+ · Guzzle 7 · PSR-18

Stable

🅻

Laravel SDK

Opinionated wrapper around the PHP SDK: service provider, facade, publishable config.

Bientôt

⬢

Node.js / TypeScript SDK

Native TypeScript · ESM + CJS · Node 18+ · Bun + Deno compatible

Stable

🐍

Python SDK

PyPI · Python 3.9+ · full type hints · httpx

Stable

Shared conventions

All Zayono SDKs share the following conventions — learn them once, use them everywhere:

Authentication

Every request uses an API key in the zyn_test_... (sandbox) or zyn_live_... (live) format, passed in the Authorization: Bearer <key> header. See Authentication.

Idempotency

All mutating requests (POST / PATCH / DELETE) accept an Idempotency-Key header. The SDKs generate one automatically if you don't supply it. See Idempotency.

Retries

Network failures / 5xx / 429 are retried automatically with exponential backoff (3 attempts by default, 250ms → 1s → 4s). Configurable per client.

Pagination

List endpoints (/payments, /payouts, /customers) return a paginated envelope:

{
  "data": [/* ... */],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 142,
    "last_page": 10
  }
}

Every SDK exposes an async iterator that walks through the pages automatically.

Errors

The SDKs throw a typed exception per error class:

• AuthenticationException — invalid or revoked key
• ValidationException — invalid fields (errors details field by field)
• RateLimitException — rate limit exceeded
• ResourceNotFoundException — 404
• ServerException — 5xx (already retried)
• NetworkException — connection failure / timeout

See Error handling.

Webhooks

Each SDK exposes a verifyWebhook(payload, signature, secret) helper that validates the HMAC-SHA256 signature of the raw body and returns true/false. See Signature verification.

Distribution

Language	Package manager	Repo
PHP	packagist.org/packages/zayono/zayono-php	github.com/zayono/zayono-php
Laravel	packagist.org/packages/zayono/zayono-laravel	github.com/zayono/zayono-laravel
Node.js	npmjs.com/package/@zayono/sdk	github.com/zayono/zayono-node
Python	pypi.org/project/zayono	github.com/zayono/zayono-python

Versioning

Every SDK follows SemVer:

• Major (1.x → 2.x): breaking changes documented in the Changelog
• Minor (1.0 → 1.1) : new backward-compatible features
• Patch (1.0.0 → 1.0.1): bugfixes

The Zayono API itself is versioned via the /api/v1 prefix. A major API version bump (/v2) triggers a major SDK bump.

Roadmap

SDK	Current version	Upcoming features
PHP	1.0.0	Async via ReactPHP, PSR-14 event support
Laravel	1.0.0	Artisan commands, auto-dispatched queue jobs
Node.js	1.0.0	Streaming responses, WebSocket subscriptions
Python	1.0.0	Async via native asyncio, Django middleware