Skip to main content

API Authentication for Partner vs. Business Implementations

Each Commenda Global Indirect Tax API organization receives an API token, whether the organization manages multiple corporations (Partner Implementation) or a single corporation (Business Implementation). Include this token on each request as Authorization: Bearer <api_token>.

Corporations

In Commenda’s system, a corporation refers to a distinct legal entity or business that the API interacts with. Users can set up corporations in two main ways:
  • Partner Implementations: For users managing multiple businesses (such as merchants or clients), each entity they handle is treated as a separate corporation within the API. This is useful when different legal entities require separate records or compliance processes.
  • Business Implementations: For users building the API for their own company, only one corporation needs to be created, representing the user’s business.

Use Case Labels

  • Partner Implementations: For users managing multiple corporations.
  • Business Implementations: For users managing a single corporation for their own business.

Corporations and Their Relationship with Other Resources

Most resources in the system, such as customers, transactions, registrations, filings, and files, are linked to a specific corporation. When working with these resources, provide the corporation_id for context where the endpoint requires it. You can retrieve all corporations associated with your organization by using the GET /corporations endpoint.