---
title: "Collect SaaS Order Forms With Countersignature"
description: "Let a customer pick a plan from a dropdown, accept the terms and sign, while your company countersigns automatically and the choices come back as captures."
canonical: "https://signatureapi.com/docs/use-cases/saas-order-forms"
source: "https://signatureapi.com/docs/use-cases/saas-order-forms.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T17:35:55Z"
---

# Collect SaaS Order Forms With Countersignature

Let a customer pick a plan from a dropdown, accept the terms and sign, while your company countersigns automatically and the choices come back as captures.

_Last verified against API version 1.18.0._

A self-serve order form needs three things from the customer: a plan, acceptance of the terms and a signature. Your company countersigns every order the same way, so use an automatic signer and skip the wait. The plan choice is stored on the envelope, ready for your billing system.

## Envelope shape

- **A dropdown for the plan.** The `plan` place is a `dropdown` with custom `options`, each with a `label` and a `value`. `capture_as: "plan"` stores the selected value in the envelope's `captures`. See [Dropdown places](https://signatureapi.com/docs/api/resources/places/dropdown).
- **A required terms checkbox.** The `accept_terms` place is a `checkbox` with `requirement: "required"`, captured as `accepted_terms`. See [Capturing input](https://signatureapi.com/docs/api/resources/envelopes/captures).
- **An automatic signer.** Your company is an `automatic_signer` with a `signature` image from `POST /v1/uploads` and a `mandate`. No email is sent and no ceremony is created. See [Automatic signer](https://signatureapi.com/docs/api/resources/recipients/automatic-signer).
- **Metadata.** `order_id` and `crm_deal` tie the envelope to your billing and CRM records.

## Routing

The envelope uses `sequential` routing, which dropdown and checkbox places require. The customer is the only recipient who acts. The automatic signer applies its signature when the envelope is created. See [Recipient routing](https://signatureapi.com/docs/api/resources/envelopes/routing).

## Webhooks to listen for

- [`recipient.completed`](https://signatureapi.com/docs/api/resources/events/recipient-events): the customer signed. Read `envelope_metadata.order_id` to find the order.
- [`envelope.completed`](https://signatureapi.com/docs/api/resources/events/envelope-events): the order is fully signed. Retrieve the envelope, read `captures.plan` and `captures.accepted_terms`, and provision the plan.
- [`deliverable.generated`](https://signatureapi.com/docs/api/resources/events/deliverable-events): download the signed order form and attach it to the CRM deal.

Set up the endpoint as shown in [Set up webhooks](https://signatureapi.com/docs/api/guides/how-to/set-up-webhooks).

## Compliance notes

This is general information, not legal advice. An automatic signer signs without a person interacting with the document, and its legal weight differs by jurisdiction, as the [automatic signer](https://signatureapi.com/docs/api/resources/recipients/automatic-signer) page explains. Have counsel review your order terms and your mandate.

### Example: Default

Order Form - Acme Corp Team Plan (sample).

```http
POST /v1/envelopes HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "title": "Order Form - Acme Corp Team Plan (sample)",
  "message": "Choose your plan, accept the terms and sign.",
  "routing": "sequential",
  "metadata": {
    "order_id": "ord_9001",
    "crm_deal": "deal_77"
  },
  "topics": [
    "sales",
    "order_forms"
  ],
  "documents": [
    {
      "key": "order_form",
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "place_key": "plan",
          "page": 1,
          "top": 130,
          "left": 210
        },
        {
          "place_key": "accept_terms",
          "page": 1,
          "top": 150,
          "left": 210
        },
        {
          "place_key": "customer_signature",
          "page": 1,
          "top": 172,
          "left": 210
        },
        {
          "place_key": "acme_countersignature",
          "page": 1,
          "top": 186,
          "left": 220
        }
      ],
      "places": [
        {
          "key": "plan",
          "type": "dropdown",
          "recipient_key": "customer",
          "prompt": "Plan",
          "options": [
            {
              "label": "Team",
              "value": "team"
            },
            {
              "label": "Business",
              "value": "business"
            }
          ],
          "width": 120,
          "capture_as": "plan"
        },
        {
          "key": "accept_terms",
          "type": "checkbox",
          "recipient_key": "customer",
          "requirement": "required",
          "capture_as": "accepted_terms"
        },
        {
          "key": "customer_signature",
          "type": "signature",
          "recipient_key": "customer"
        },
        {
          "key": "acme_countersignature",
          "type": "signature",
          "recipient_key": "acme"
        }
      ]
    }
  ],
  "recipients": [
    {
      "type": "signer",
      "key": "customer",
      "name": "Jane Doe",
      "email": "jane.doe@example.com"
    },
    {
      "type": "automatic_signer",
      "key": "acme",
      "name": "Acme Corp Authorized Signatory",
      "signature": {
        "type": "drawn",
        "url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
      },
      "mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)"
    }
  ]
}
```

Response 201 Created:

```json
{
  "id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
  "title": "Order Form - Acme Corp Team Plan (sample)",
  "label": null,
  "message": "Choose your plan, accept the terms and sign.",
  "status": "processing",
  "attestation": "none",
  "language": "en",
  "mode": "test",
  "routing": "sequential",
  "timezone": "UTC",
  "timestamp_format": "MM/DD/YYYY HH:mm:ss",
  "snapshot_url": null,
  "branding": {
    "logo": null,
    "accent_color": "#2463EB",
    "email": {
      "footer": null,
      "logo_position": "left",
      "from": "noreply@signatureapi.com"
    }
  },
  "deliverable": {
    "id": "del_HVl3Nj7XzTzX7jN3lVH5vn",
    "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
    "name": null,
    "status": "pending",
    "type": "standard",
    "url": null,
    "password": null,
    "created_at": "2026-11-02T14:03:11.000Z",
    "generated_at": null,
    "timezone": "UTC",
    "language": "en",
    "timestamp_format": "MM/DD/YYYY HH:mm:ss",
    "included_documents": [
      "order_form"
    ]
  },
  "metadata": {
    "order_id": "ord_9001",
    "crm_deal": "deal_77"
  },
  "sender": {
    "name": "Acme Corp Legal",
    "email": "legal@acme.example",
    "organization": "Acme Corp"
  },
  "captures": {
    "accepted_terms": false,
    "plan": null
  },
  "documents": [
    {
      "id": "doc_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "key": "order_form",
      "title": null,
      "page_count": 1,
      "url": "https://pub-9cb75390636c4a8a83a6f76da33d7f45.r2.dev/docs-samples/service-agreement.pdf",
      "format": "pdf",
      "fixed_positions": [
        {
          "page": 1,
          "top": 130,
          "left": 210,
          "place_key": "plan"
        },
        {
          "page": 1,
          "top": 150,
          "left": 210,
          "place_key": "accept_terms"
        },
        {
          "page": 1,
          "top": 172,
          "left": 210,
          "place_key": "customer_signature"
        },
        {
          "page": 1,
          "top": 186,
          "left": 220,
          "place_key": "acme_countersignature"
        }
      ],
      "places": [
        {
          "key": "plan",
          "type": "dropdown",
          "recipient_key": "customer",
          "capture_as": "plan",
          "hint": null,
          "prompt": "Plan",
          "requirement": "required",
          "font_size": 12,
          "width": 120,
          "default": null,
          "behavior": "auto",
          "options": [
            {
              "label": "Team",
              "value": "team"
            },
            {
              "label": "Business",
              "value": "business"
            }
          ]
        },
        {
          "key": "accept_terms",
          "type": "checkbox",
          "recipient_key": "customer",
          "height": 20,
          "symbol": "check",
          "capture_as": "accepted_terms",
          "requirement": "required"
        },
        {
          "key": "customer_signature",
          "type": "signature",
          "recipient_key": "customer",
          "height": 60
        },
        {
          "key": "acme_countersignature",
          "type": "signature",
          "recipient_key": "acme",
          "height": 60
        }
      ]
    }
  ],
  "recipients": [
    {
      "id": "re_HVl3Nj7XzTzX7jN3lVH5vn",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "signer",
      "key": "customer",
      "email": "jane.doe@example.com",
      "name": "Jane Doe",
      "ceremony": {
        "authentication": [
          {
            "type": "email_link",
            "subject_override": null,
            "message_override": null
          }
        ],
        "embeddable_in": [],
        "redirect_url": null,
        "redirect_delay": 3,
        "url": null,
        "url_variant": "standard"
      },
      "ceremony_creation": "automatic",
      "delivery_type": "email",
      "signature_options": [
        "typed",
        "drawn"
      ],
      "status": "pending",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    },
    {
      "id": "re_OcsAUqEe6a6eEqUAscOC2u",
      "envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
      "type": "automatic_signer",
      "key": "acme",
      "name": "Acme Corp Authorized Signatory",
      "signature": {
        "type": "drawn",
        "url": "https://api.signatureapi.com/v1/uploads/upl_2bC6tF9gHk3LmQ8rSx5Vy7"
      },
      "initials": null,
      "mandate": "Authorized by Acme Corp board resolution 2026-04 (synthetic example)",
      "status": "awaiting",
      "status_updated_at": "2026-11-02T14:03:11.000Z",
      "completed_at": null
    }
  ],
  "topics": [
    "sales",
    "order_forms"
  ],
  "created_at": "2026-11-02T14:03:11.000Z",
  "completed_at": null
}
```

Response 422 Unprocessable Content:

```json
{
  "type": "https://signatureapi.com/docs/v1/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The request body contains validation errors.",
  "errors": [
    "recipients[0].email must be a valid email address"
  ]
}
```

Errors that any request can return (authentication, rate limits, server errors) are on the [Errors](https://signatureapi.com/docs/api/errors) and [Authentication](https://signatureapi.com/docs/api/authentication) pages.
