Skip to content
ZiaSignZiaSign
ZiaSign
  • How it works
  • Free PDF Tools
  • Documentation
  • Pricing

  • Company

    • About
    • Blog
    • Investors
    • Security

    Compare

    • vs DocuSign
    • vs Adobe Sign
    • vs PandaDoc
    • vs iLovePDF
    • vs Smallpdf
    • vs PDF24
    • vs Sejda
    Investor connectLatest blog
  • Free PDF ToolsFree
  • Browse use casesNew
  • How-to guides100+
  • How it works
  • Pricing
  • Documentation

Theme

Light mode

Sign Now
Sign Now
  1. Home
  2. Documentation
  3. Developer API
  4. Sandbox & Testing
Developer API

Sandbox & Testing

Use the sandbox environment to test your integration with simulated documents, signers, and events.

Last updated April 14, 2026
Quickstart GuideAccount & Organization SettingsDocument TemplatesSecurity & ComplianceHelp & Support
Sending Documents for SignatureThe Signing ExperienceAudit Trail & Legal ValidityBulk SendPDF ToolsDocument Editor & StudioDocument LibraryAnalytics & Reports
API AuthenticationDocuments APIWebhooksSandbox & TestingEmbedded SigningIntegrations
AI Contract AnalysisAI Smart Workflows
Plans & PricingBilling & InvoicesReferral Program
Mobile App Guide
Changelog & Release Notes

Overview

The sandbox environment is a full copy of the ZiaSign API that uses test data. Use it to develop and test your integration before going live.

Sandbox vs. Production

FeatureSandboxProduction
Base URLhttps://sandbox.ziasign.com/api/v1https://api.ziasign.com/api/v1
API KeysSeparate sandbox keysProduction keys
DocumentsNot legally bindingLegally binding
EmailsNot delivered to real recipientsDelivered to real recipients
WebhooksDelivered with sandbox: true flagDelivered without flag
Rate LimitsSame as your planSame as your plan
Data RetentionCleared monthlyPer your plan's retention policy

Getting Started

  1. Go to Dashboard → Developer APIs → Credentials tab
  2. Toggle the Sandbox switch
  3. Create a sandbox API key
  4. Use https://sandbox.ziasign.com/api/v1 as your base URL

Test Signers

In the sandbox, send documents to any email address ending in @sandbox.ziasign.com:



Auto-Sign


Simulate a signer completing their fields instantly:




This triggers the full signing flow: the document status changes, audit trail entries are created, and webhook events fire.


Testing Webhooks


    

  1. Register a webhook endpoint (use a tool like webhook.site for quick testing)
    2. 

  2. Create and send a document in the sandbox
    3. 

  3. Use auto-sign to trigger signing events
    4. 

  4. Verify your endpoint receives the correct payloads
    5. 



Sandbox webhook payloads include an extra field:




Test Payments


When testing billing integration in the sandbox, ZiaSign uses Razorpay as the payment gateway. In sandbox mode, Razorpay provides a test checkout that simulates various payment scenarios:


    

  • Card — Use Razorpay's test card numbers (see Razorpay Test Cards)
    • 

  • UPI — Use success@razorpay for successful payments or failure@razorpay for failures
    • 

  • Netbanking / Wallet — Select any option and choose success or failure on the test page
    • 





Note: Sandbox payments are never charged. All transactions are simulated.




Going Live Checklist


Before switching to production:


    

  •  Replace sandbox base URL with production URL
    • 

  •  Generate production API keys
    • 

  •  Verify webhook signature verification is working
    • 

  •  Test error handling for rate limits and timeouts
    • 

  •  Review API key scopes — use minimum required permissions
    • 

  •  Remove any test/sandbox references from your code
    • 

Frequently asked questions
Is the sandbox free?
Yes. The sandbox is free for all plans and has no document limits. It uses test data only.
Can I test webhooks in the sandbox?
Yes. Sandbox events trigger webhook deliveries to your registered endpoints, using the same payloads as production with a 'sandbox' flag.
How do I simulate signing?
Send a document to a sandbox email (any @sandbox.ziasign.com address). Use the auto-sign API endpoint to simulate the signer completing their fields instantly.
Related documentation
API Authentication
Authenticate your API requests using API keys with HMAC-SHA256 request signing for maximum security.
Webhooks
Receive real-time HTTP notifications when documents are viewed, signed, completed, or declined.
Documents API
Create, send, retrieve, download, and manage documents programmatically via the REST API.
Previous
Webhooks
Next
Embedded Signing
On this page
OverviewSandbox vs. ProductionGetting StartedTest SignersAuto-SignTesting WebhooksTest PaymentsGoing Live Checklist
Product
  • How it works
  • Pricing
  • About
  • Blog
  • Security
Documentation
  • All Docs
  • Quickstart
  • API Authentication
  • Webhooks
  • Templates
  • Integrations
Free PDF Tools
  • All Tools
  • How-To Guides
  • Use-Case Guides
  • Organize PDFs
  • Convert PDFs
  • Edit PDFs
  • Security
  • Optimize
  • AI Tools
Compare
  • vs DocuSign
  • vs Adobe Sign
  • vs PandaDoc
  • vs iLovePDF
  • vs Smallpdf
  • vs PDF24
  • vs Sejda
Company
  • FAQs
  • Investors
  • Privacy Policy
  • Terms of Services
ZiaSignZiaSign
ZiaSign
AI-native e-signature and document workflows for modern teams.
© 2026 ZiaSign. All rights reserved.
json
{
  "signers": [
    { "name": "Test Signer", "email": "signer1@sandbox.ziasign.com" }
  ]
}
bash
curl -X POST "https://sandbox.ziasign.com/api/v1/documents/{id}/auto-sign" \
  -H "X-Api-Key: $SANDBOX_API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Signature: $SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{ "signerEmail": "signer1@sandbox.ziasign.com" }'
json
{
  "id": "evt_test_123",
  "type": "document.completed",
  "sandbox": true,
  "data": { ... }
}