{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Reseller model","siteUrl":"https://developers.signable.app","description":"Integrate Signable’s eSignature API to send, sign, and manage documents with envelopes and webhooks.","image":"/assets/hero-placeholder-small.5b052639e5d5a3b6265375db1ac2835173dda2c0ed22f8c167f6284080cc84ce.db81178d.png","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"reseller-model","__idx":0},"children":["Reseller model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The reseller model is the account and billing structure used by Reseller Partners. It uses a two-level account structure: the partner holds one Signable partner account, and each of the partner’s customers has a sub-account beneath it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide covers the account architecture, available API endpoints, and division of responsibilities between the partner and Signable."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/reseller-diagram.ad14d56e9ad395937654a4d7d035770bb3cb0a4b6ca83f5e956e81c42953a942.9c1bb791.png","alt":"Two-level reseller account structure.","framed":false,"withLightbox":true,"width":"1200"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-structure","__idx":1},"children":["Account structure"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A partner account supports an unlimited number of sub-accounts."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each sub-account represents one customer and can have its own branding for signature-request emails and signing pages."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Day-to-day operations are carried out through the API. As an exception, partners can set up templates manually in the Signable web app."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envelope usage is aggregated across all sub-accounts and invoiced to the partner at the end of each billing period."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sub-account-structure","__idx":2},"children":["Sub-account structure"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each sub-account can have only one associated user and email address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sub-account customers cannot access the Signable web app. Where web-app configuration is required, such as manual template setup, the partner completes it through the partner account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reseller-partner-compared-with-direct-customer","__idx":3},"children":["Reseller partner compared with direct customer"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Aspect"},"children":["Aspect"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Reseller model"},"children":["Reseller model"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Direct account"},"children":["Direct account"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Interface"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API only; no web app login for day-to-day operation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signable web app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Branding"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partner or sub-account branding (white label)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signable or customer branding"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Support"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partner supports their customers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signable supports the customer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monthly, in arrears, for aggregate sub-account usage; Direct Debit or card"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standard pricing plans, in advance"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Templates"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set up in the web app by the partner"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Managed by the customer in the web app"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"signable-api","__idx":4},"children":["Signable API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You will use your partner account API key to access the partner endpoints. You will use sub-account API keys to interact with all other endpoints. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/partners/reseller-authentication"},"children":["Authentication for resellers"]}," for more information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Signature events are delivered to your platform using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/webhooks"},"children":["webhooks"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To embed the signing experience in your product’s user interface, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/embedded-signing/embedded"},"children":["Embedded signing"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For error responses specific to these endpoints, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/errors/partners-errors"},"children":["Partner error codes"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Signable's role is limited to explaining how the API behaves during the build and in operation. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/partners/getting-started#2-integration-build-and-testing"},"children":["Integration build and testing"]}," ",")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"billing","__idx":5},"children":["Billing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reseller pricing depends on volume and use case. For more information, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.signable.com/signable-partnership/#sign-up-partners"},"children":["contact the Sales team"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Set at partner plan activation, recurs monthly"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Timing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["In arrears"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invoice amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The standing charge or total sub-account usage, whichever is higher"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment methods"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct Debit or card"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Invoice amounts vary month to month with sub-account activity, and the standing charge sets the floor. Signable invoices the partner as a single account for usage across all sub-accounts. The partner bills its own end customers separately."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pricing-the-feature-for-your-customers","__idx":6},"children":["Pricing the feature for your customers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partners price and bill the feature independently of Signable. Signable does not prescribe how partners charge their customers. Common models include the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Per-envelope"]},": pass usage costs through to each sub-account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subscription tier"]},": include integrated eSignatures in a higher plan tier."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credit bundles"]},": sell envelope credits in packs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Absorbed cost"]},": provide eSignatures at no charge as a platform feature."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"usage-tracking-using-the-api","__idx":7},"children":["Usage tracking using the API"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve usage for all sub-accounts, with current and previous period comparison"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/partners/getcompaniesusage"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /usage"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve sub-account ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_id"]}," values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/openapi/partners/getcompanies"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /companies"]}]}]}]}]}]}]}]},"headings":[{"value":"Reseller model","id":"reseller-model","depth":1},{"value":"Account structure","id":"account-structure","depth":2},{"value":"Sub-account structure","id":"sub-account-structure","depth":3},{"value":"Reseller partner compared with direct customer","id":"reseller-partner-compared-with-direct-customer","depth":3},{"value":"Signable API","id":"signable-api","depth":2},{"value":"Billing","id":"billing","depth":2},{"value":"Pricing the feature for your customers","id":"pricing-the-feature-for-your-customers","depth":3},{"value":"Usage tracking using the API","id":"usage-tracking-using-the-api","depth":3}],"frontmatter":{"title":"Reseller Model","description":"Sub-account architecture, API operations, division of responsibilities, and pricing for reseller partners","category":"Partners","keywords":["reseller","sub-accounts","white label","branding","templates","webhooks","envelopes","usage","pricing","billing","arrears","setup fee","direct debit","API operations","status page","embedded widgets","responsibilities"],"seo":{"title":"Reseller model"}},"lastModified":"2026-08-13T08:43:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/partners/reseller-model","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}