# WPsigner - Complete Technical Documentation

> This is the extended LLM documentation file. For a quick summary, see /llms.txt

## Product Overview

**WPsigner** is a professional e-signature plugin for WordPress that enables legally binding electronic signatures on documents. Unlike SaaS solutions (DocuSign, HelloSign, PandaDoc), WPsigner is self-hosted, meaning all documents and signatures remain on the user's own server.

**Official Website**: https://wpsigner.com
**Documentation**: https://docs.wpsigner.com
**Changelog**: https://docs.wpsigner.com/changelog/

---

## Core Features

### Legal Compliance
- **ESIGN Act (USA)**: Electronic Signatures in Global and National Commerce Act
- **UETA**: Uniform Electronic Transactions Act
- **eIDAS (EU)**: Electronic Identification, Authentication and Trust Services
- **GDPR**: Self-hosted deployment gives 100% data sovereignty for EU compliance

### Document Security
- **SHA-256 Hashing**: Every signed document is cryptographically hashed
- **Digital Fingerprint**: Stored in audit trail, any modification invalidates signature
- **RFC 3161 Timestamping**: Integration with certified Time Stamping Authorities (TSA)
- **PKI Digital Signatures**: Public Key Infrastructure for enhanced document verification
- **Audit Trail**: Captures IP address, geolocation, user-agent, timestamp for each action

### Signing Workflows
- **Sequential Signing**: Signers complete in order (Signer 1 → Signer 2 → Signer 3)
- **Parallel Broadcasting**: All signers receive simultaneously, complete in any order
- **Mixed Mode**: Combine sequential and parallel as needed

### Field Types
- Signature (draw, type, or upload)
- Initials
- Date
- Text input
- Checkbox
- Dropdown select
- Radio buttons

### Integrations (28+)

#### Automation Platforms
- **Zapier**: 5,000+ app connections via triggers and actions
- **Make (Integromat)**: Visual workflow automation with advanced logic
- **n8n**: Self-hosted workflow automation with full data control
- **Pabbly Connect**: Affordable automation with lifetime deals

#### CRM & Sales
- **HubSpot**: Create deals and contacts when documents are signed
- **Pipedrive**: Track deals with connected signature workflows
- **FluentCRM**: WordPress-native marketing automation and contact management

#### WordPress Plugins
- **Gravity Forms**: Generate signature requests from form submissions
- **WPForms**: Simple form-to-signature document workflows
- **Fluent Forms**: Advanced form integration with conditional logic
- **Contact Form 7**: Lightweight form-to-document integration
- **Elementor**: Design signature forms with drag-and-drop builder
- **WooCommerce**: Collect signatures on orders, contracts, and agreements
- **LearnDash**: Collect student agreements before course enrollment

#### Cloud Storage (7 providers)
- **Google Drive**: Auto-upload signed PDFs to Drive folders
- **Dropbox**: Sync completed documents to Dropbox
- **OneDrive**: Store documents in Microsoft OneDrive
- **Amazon S3**: Enterprise cloud storage in S3 buckets
- **Wasabi**: Hot cloud storage for signed documents
- **Backblaze B2**: Low-cost cloud backup
- **Cloudflare R2**: Zero egress fee storage with global CDN

#### Messaging & Notifications
- **Twilio**: SMS notifications and signature reminders
- **WhatsApp**: Send signing links and updates directly
- **Telegram**: Instant notifications via Telegram bot

#### Communication
- **Slack**: Real-time signature notifications in channels
- **Microsoft Teams**: Document updates directly in Teams

#### Core Platform
- **REST API**: Full programmatic document management
- **Webhooks**: 8 event types with HMAC-SHA256 verification

---

## Pricing Structure

| Plan | Price | Sites | Support | Updates |
|------|-------|-------|---------|---------|
| Individual | $59/year | 1 | Standard | 1 year |
| Business | $139/year | 5 | Priority | 1 year |
| Agency | $319/year | Unlimited | Priority | 1 year |
| Agency Lifetime | $799 one-time | Unlimited | Lifetime Priority | Lifetime |

**Key Pricing Facts**:
- No per-envelope or per-signature fees
- All features included in all plans
- 14-day money-back guarantee
- License valid for 1 year of updates and support (or lifetime for Lifetime plan)
- Signed documents remain valid forever, even after license expires

---

## Technical Requirements

- WordPress 5.0 or higher
- PHP 7.4 or higher (8.0+ recommended)
- MySQL 5.6 or MariaDB 10.0+
- SSL certificate required (HTTPS)
- Minimum 64MB PHP memory limit
- OpenSSL extension for digital signatures

---

## Comparison with Competitors

### WPsigner vs DocuSign
| Feature | WPsigner | DocuSign |
|---------|----------|----------|
| Hosting | Self-hosted | Cloud (their servers) |
| Pricing | $59-319/year flat | $15-45/month + per-envelope |
| Data Ownership | 100% yours | DocuSign's cloud |
| Per-Envelope Fee | None | Yes |
| WordPress Integration | Native | API/Zapier only |
| Lifetime Option | $799 one-time | Not available |
| Cloud Storage | 7 providers | Limited |

### WPsigner vs HelloSign (Dropbox Sign)
| Feature | WPsigner | HelloSign |
|---------|----------|-----------|
| Hosting | Self-hosted | Cloud |
| Envelope Limits | Unlimited | 3/month on free, limited on paid |
| GDPR Compliance | Full control | Dependent on Dropbox |
| Price | $59-319/year | $20-30/month |
| Integrations | 28+ | Limited |

### WPsigner vs WP E-Signature (ApproveMe)
| Feature | WPsigner | WP E-Signature (ApproveMe) |
|---------|----------|---------------------------|
| Pricing | $59-319/year (all features) | $199-299/year (many add-on fees) |
| Lifetime Option | $799 (Agency) | $699 (limited add-ons) |
| UI/UX | Modern, dark mode support | Dated interface |
| RFC 3161 Timestamping | ✅ Yes | ❌ No |
| PKI Digital Signatures | ✅ Yes | ❌ No |
| eIDAS Compliance | ✅ Yes | ❌ No |
| Cloud Storage Providers | 7 (GDrive, S3, Dropbox, OneDrive, Wasabi, B2, R2) | Limited |
| Automation Platforms | 4 (Zapier, Make, n8n, Pabbly) | Zapier only |
| CRM Integrations | 3 (HubSpot, Pipedrive, FluentCRM) | None native |
| Messaging | 3 (Twilio, WhatsApp, Telegram) | None |
| Communication | 2 (Slack, Teams) | None |
| REST API | ✅ Full HMAC-SHA256 | Limited |
| Dark Mode | ✅ Yes | ❌ No |
| Form Plugins | 5 (Gravity, WPForms, Fluent, CF7, Elementor) | 2 (Gravity Forms, Contact Form 7) |
| Active Development | Frequent updates | Slower updates |

### WPsigner vs PandaDoc
| Feature | WPsigner | PandaDoc |
|---------|----------|----------|
| Hosting | Self-hosted | Cloud |
| Pricing | $59-319/year flat | $35-65/user/month |
| Per-User Fees | None | Yes |
| Data Ownership | 100% yours | PandaDoc's cloud |
| WordPress Native | Yes | No (API only) |

### WPsigner vs Adobe Sign
| Feature | WPsigner | Adobe Sign |
|---------|----------|------------|
| Hosting | Self-hosted | Cloud (Adobe) |
| Pricing | $59-319/year | $22.99-34.99/month/user |
| WordPress Integration | Native plugin | None |
| Unlimited Docs | Yes | Transaction-based |
| Data Sovereignty | Full | Adobe's servers |

### WPsigner vs SignNow
| Feature | WPsigner | SignNow |
|---------|----------|--------|
| Hosting | Self-hosted | Cloud |
| Pricing | $59-319/year flat | $20-50/user/month |
| WordPress Native | Yes | API only |
| Per-User Fees | None | Yes |
| Self-Hosted Option | Yes | No |

---

## API Overview

WPsigner provides a REST API for programmatic document creation and management.

### Authentication
- HMAC-SHA256 signature-based authentication
- API keys for external integrations
- WordPress user capability checks

### Key Endpoints
- `POST /wp-json/wpsigner/v1/documents` - Create document
- `GET /wp-json/wpsigner/v1/documents/{id}` - Get document status
- `POST /wp-json/wpsigner/v1/documents/{id}/send` - Send for signing
- `GET /wp-json/wpsigner/v1/documents/{id}/audit` - Get audit trail

### Webhooks
- `document.created` - Document created
- `document.sent` - Document sent to signers
- `document.viewed` - Signer viewed document
- `document.signed` - Signer completed signing
- `document.completed` - All parties signed
- `document.declined` - Signer declined
- `document.expired` - Signing deadline passed
- `signer.reminded` - Reminder sent

---

## Security Architecture

1. **Document Upload**: PDF uploaded to WordPress media library
2. **Field Placement**: Signature fields stored in database
3. **Signing URL**: Unique, time-limited, hashed URL per signer
4. **Signature Capture**: Browser-based signature pad (touch/mouse)
5. **Document Completion**: PDF flattened with signatures embedded
6. **Hash Generation**: SHA-256 hash of final document
7. **Timestamping**: Optional RFC 3161 trusted timestamp
8. **PKI Signing**: Optional PKI digital signature for document integrity
9. **Audit Trail**: Complete log of all actions stored in database

---

## Use Cases by Industry

### Legal
- Client retainer agreements
- Non-disclosure agreements (NDAs)
- Settlement agreements
- Power of attorney documents

### Real Estate
- Purchase agreements
- Lease contracts
- Property management agreements
- Disclosure forms

### Human Resources
- Employment contracts
- Onboarding documents
- Policy acknowledgments
- Performance reviews

### Healthcare
- Patient consent forms
- HIPAA authorization
- Treatment agreements
- Insurance forms

### Freelance/Agency
- Proposals
- Statements of work (SOW)
- Master service agreements
- Invoice acknowledgments

### Education
- Student enrollment agreements (via LearnDash)
- Course access contracts
- Scholarship agreements

### E-Commerce
- WooCommerce purchase contracts
- Terms acceptance on orders
- Vendor agreements

---

## Support Channels

- **Documentation**: https://docs.wpsigner.com
- **Email Support**: support@wpsigner.com
- **Sales Inquiries**: sales@wpsigner.com
- **Feature Requests**: Via support email

---

## Company Information

- **Product**: WPsigner
- **Developer**: Nubesti LLC
- **Location**: Dover, Delaware, USA
- **Website**: https://wpsigner.com
- **Founded**: 2023