Интеграция электронной подписи 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 дня. Стоимость рассчитывается индивидуально.

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