Интеграция электронной подписи SignNow на сайт

Руководитель интернет-магазина тратил до 2 часов на согласование договоров с клиентами — после интеграции с SignNow время сократилось до 5 минут. Подключение электронной подписи к сайту часто тормозится сложной настройкой JWT, SDK и длительных согласований. SignNow от airSlate выделяется простым REST API и доступной ценой. Наша команда за время работы реализовала более 30 таких интеграций — от небольших интернет-магазинов до корпоративных порталов. Средняя экономия времени на подписание — до 70%. Свяжитесь с нами для консультации — мы подготовим решение под ваш проект.

Как SignNow снижает затраты на документооборот?

SignNow не требует покупки SDK и сложной инфраструктуры. Достаточно OAuth 2.0 и прямых REST-запросов. По данным официального REST API SignNow, система выдерживает до 1000 запросов в минуту — хватает для любого среднего бизнеса. Затраты на интеграцию окупаются за 2–3 месяца за счёт сокращения ручного труда. Сравните: ручное согласование договора в среднем занимает 2 часа, с SignNow — 5–10 минут.

Как настроить аутентификацию в SignNow?

SignNow использует OAuth 2.0 с грантом client_credentials для серверных интеграций. Это проще, чем у DocuSign — не нужен JWT или Legacy Header. Вот как мы получаем токен:

class SignNowAuthService {
    private string $baseUrl = 'https://api.signnow.com';

    public function getToken(): string
    {
        $response = Http::withBasicAuth(
            config('services.signnow.client_id'),
            config('services.signnow.client_secret')
        )->asForm()->post("{$this->baseUrl}/oauth2/token", [
            'grant_type' => 'client_credentials',
            'scope' => '*',
        ]);

        $token = $response->json('access_token');
        Cache::put('signnow_token', $token, now()->addMinutes(55));

        return $token;
    }

    public function token(): string
    {
        return Cache::get('signnow_token') ?? $this->getToken();
    }
}

Токен живёт 3600 секунд, мы кешируем его с запасом в 5 минут. Для операций от имени конкретного пользователя используется Password Grant, но в большинстве кейсов достаточно client_credentials.

Загрузка документа и простановка полей

После аутентификации загружаем PDF (максимальный размер — 50 МБ) и добавляем поля подписей. SignNow поддерживает smart fields — если в PDF есть анкоры вида [[sig|req|signer1]], поля подписи ставятся автоматически. Это удобнее, чем вычислять координаты вручную.

class SignNowDocumentService {
    public function __construct(private SignNowAuthService $auth) {}

    public function uploadDocument(string $pdfPath, string $fileName): string {
        $response = Http::withToken($this->auth->token())
            ->attach('file', file_get_contents($pdfPath), $fileName)
            ->post('https://api.signnow.com/document');

        return $response->json('id');
    }

    public function addSignatureFields(string $documentId, array $signers): void {
        $fields = [];
        $roleIndex = 0;

        foreach ($signers as $signer) {
            $fields[] = [
                'type' => 'signature',
                'role' => $signer['role'] ?? "Signer {$roleIndex}",
                'role_id' => (string)$roleIndex,
                'required' => true,
                'height' => 40,
                'width' => 200,
                'x' => 100,
                'y' => 600,
                'page_number' => 0,
            ];
            $roleIndex++;
        }

        Http::withToken($this->auth->token())
            ->put("https://api.signnow.com/document/{$documentId}", ['fields' => $fields]);
    }
}

Мы используем анкоры — это сокращает время интеграции и исключает ошибки позиционирования.

Как отправить документ на подпись и получить статус?

Для отправки приглашения подписантам используем метод invite. SignNow позволяет настроить напоминания и срок действия:

public function sendInvite(string $documentId, array $signers): string {
    $recipients = [];
    foreach ($signers as $index => $signer) {
        $recipients[] = [
            'email' => $signer['email'],
            'role' => $signer['role'] ?? "Signer {$index}",
            'role_id' => (string)$index,
            'order' => $index + 1,
            'reminder' => [
                'remind_before' => 0,
                'remind_after' => 3,
                'remind_repeat' => 2,
            ],
            'expiration_days' => 30,
            'subject' => 'Пожалуйста, подпишите документ',
            'message' => "Здравствуйте, {$signer['name']}! Прошу вас подписать прикреплённый документ.",
        ];
    }
    $response = Http::withToken($this->auth->token())
        ->post("https://api.signnow.com/document/{$documentId}/invite", [
            'to' => $recipients,
            'from' => config('services.signnow.sender_email'),
        ]);
    return $response->json('status');
}

После подписания SignNow присылает вебхук. Мы регистрируем событие document.complete и обрабатываем его:

// Регистрация вебхука
Http::withToken($this->auth->token())
    ->post('https://api.signnow.com/api/v2/events', [
        'event' => 'document.complete',
        'entity_id' => $documentId,
        'action' => 'callback',
        'callback_url' => route('webhooks.signnow'),
    ]);

// Обработчик
public function handleSignNowWebhook(Request $request): Response
{
    $data = $request->json()->all();

    if (($data['event'] ?? '') === 'document.complete') {
        $documentId = $data['meta']['document_id'];
        DownloadSignedDocumentJob::dispatch($documentId);
    }

    return response()->noContent();
}

Embedded signing: подпись без перехода на SignNow

Если нужно, чтобы клиент подписал документ, не покидая ваш сайт, используем embedded signing — получаем ссылку (действует 60 минут) и встраиваем её в iframe.

public function getSigningLink(string $documentId, string $email): string {
    $response = Http::withToken($this->auth->token())
        ->post("https://api.signnow.com/link", [
            'document_id' => $documentId,
        ]);

    return $response->json('url');
}

Это работает для большинства браузеров, но требует обработки postMessage после завершения.

Почему стоит выбрать embedded signing?

Embedded signing исключает переходы на сторонний сервис — клиент остаётся на вашем сайте. Это повышает доверие и конверсию. Ссылка действительна 60 минут, после подписания отправляется postMessage, который ловит ваша страница. Если нужна более глубокая кастомизация, SignNow предоставляет возможность настроить цветовую схему iframe.

Сравнение SignNow и DocuSign

SignNow выгоднее для среднего бизнеса благодаря простоте API и ценообразованию. Средняя стоимость подписания одного документа в 2-3 раза ниже.

Типичные ошибки при интеграции

1. Не кешировать токен — каждый запрос получает новый, что замедляет работу.
2. Игнорировать вебхуки — без них не узнаете, когда документ подписан.
3. Жёстко задавать координаты полей — лучше использовать анкоры.
4. Не обрабатывать ошибки — SignNow возвращает 401 при просрочке токена, 404 при удалённом документе.

Этапы нашей работы

Что входит в нашу работу по интеграции

• Настройка OAuth и кеширования токенов
• Реализация загрузки документов и добавления smart fields
• Разработка механизма отправки invites и обработки вебхуков
• Интеграция embedded signing (если требуется)
• Написание тестов и документации

Сроки: базовая интеграция — 2–3 рабочих дня, с embedded signing — 3–4 дня. Стоимость рассчитывается индивидуально.

Получите консультацию — оценим ваш проект и предложим решение под ключ. Опыт нашей команды — десятки интеграций электронной подписи. Гарантируем надёжность и соблюдение сроков. Свяжитесь с нами — мы подготовим коммерческое предложение за один день.