README

One contract for having documents signed - whoever signs: Yousign, DocuSign, or a DocuSeal instance of one's own.

$gateway = $registry->get('contracts');                      // or 'qualified': the same calls

$envelope = $gateway->create(new Envelope('Bail', $documents, $signers, $fields, Level::SIMPLE, embedded: true));
$envelope->reference;                                        // keep it
$gateway->send($envelope);
$gateway->signingUrl($envelope, 'tenant')->url;              // the tenant signs in your page
$gateway->fetch($envelope)->status;                          // Status::COMPLETED
$signed = $gateway->download($envelope);                     // the signed documents and their evidence

This package holds the contract (GatewayInterface, the requests Create, Send, Fetch, Remind, Cancel, Download, SigningUrl, Notify, GatewayFactory, Registry), the models (Envelope, Document, File, Signer, Field, Level, Status, SignerState, Download, SigningUrl, Notification, Capabilities) and a bridge for Symfony. It needs no framework: PHP and symfony/http-client-contracts. Each gateway is a package of its own:

Package	Levels	In the page	Third party
`omnisign/yousign`	simple, advanced, qualified	yes	Yousign (Youtrust)
`omnisign/docusign`	simple	yes	DocuSign
`omnisign/docuseal`	simple	yes	none when self-hosted

What a gateway is, and is not

A gateway has documents signed: it creates the envelope, sends it, says where it stands, gives back the signed documents and the evidence of their signing. It keeps nothing for the application: store what download() gives in your own vault, with the envelope's reference.

The levels are eIDAS's (simple, advanced, qualified): a gateway that cannot reach a level refuses the envelope (InvalidConfigException), it never signs lower. A notary's authentic deed and a lawyer's deed go through their professions' own tools, not this family. It is not a vault, nor a template editor.

Documentation

Plain PHP

composer require glitchr/omnisign omnisign/docuseal

$registry = new Registry([new DocusealGatewayFactory()], [
    'contracts' => ['factory' => 'docuseal', 'options' => ['url' => 'https://sign.example.org/api', 'api_key' => getenv('DOCUSEAL_API_KEY')]],
]);

No bundle, no container: a factory per gateway package, the registry built by hand.

Symfony

Omnisign\Bridge\Symfony\OmnisignBundle does that wiring (docs/symfony.md); its components are not required by this package.

omnisign:
    gateways:
        contracts: { factory: docuseal, options: { url: 'https://sign.example.org/api', api_key: '%env(DOCUSEAL_API_KEY)%' } }

Docker

cd docker && cp .env.dist .env
docker compose run --rm omnisign gateways
docker compose run --rm omnisign bare          # plain PHP: no bundle, no container, and what PHP loaded
docker compose run --rm omnisign test

Responsibility

glitchr/omnisign and its omnisign/* providers are independent, unofficial clients: none is affiliated with, endorsed by or sponsored by the services it reaches. Each service keeps its own terms (accounts and contracts, keys, rate limits), named with a link in the "Responsibility" section of the README of each provider that reaches one. The MIT licence covers this code only and grants no right to any service or to its data.

Whoever installs and runs these packages is responsible for complying with those terms, for obtaining whatever they require, and for any use made of what they return. The authors publish them free of charge, make no commercial use of them, and accept no liability for how they are used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.

glitchr / omnisign

Package info

Security

Statistics