> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paynext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Numeral

> Automate US sales tax calculation and compliance with Numeral.

Numeral is an automated sales tax platform designed for SaaS and digital businesses. It handles tax calculation, collection, and filing across US jurisdictions.

## Provider Details

|                         |               |
| :---------------------- | :------------ |
| **Supported Countries** | United States |
| **Tax Type**            | Sales Tax     |

## Integration Guide

<Steps>
  <Step title="Get your Numeral API key">
    Log in to your [Numeral dashboard](https://app.numeralhq.com) and navigate to **API Keys**. Create keys for both test and production environments.

    See [Numeral API Keys documentation](https://docs.numeralhq.com/essentials/api-keys) for detailed instructions.
  </Step>

  <Step title="Add Numeral in PayNext">
    In **Dashboard → Integrations → Tax**, click **Add tax provider → Numeral → Connect**
  </Step>

  <Step title="Enter API key">
    * **Sandbox**: Use your Numeral `sk_test_...` key for PayNext Sandbox
    * **Production**: Use your Numeral `sk_prod_...` key for PayNext Production
  </Step>

  <Step title="Add origin address">
    Enter your business origin address—the address your products ship from or your registered business address.

    <Note>
      You can add additional office locations and employee addresses in your Numeral dashboard. Numeral automatically calculates your nexus obligations based on these parameters.
    </Note>
  </Step>

  <Step title="Select default product category">
    Choose the product category that best describes your offerings. This determines the tax rate applied to transactions.

    See [Numeral Product Categories](https://docs.numeralhq.com/essentials/product-categories) for all available categories. Most SaaS businesses use `SAAS_GENERAL`.
  </Step>

  <Step title="Set default tax behavior">
    * **Exclusive**: Tax added on top of the price (standard for US)
    * **Inclusive**: Tax included in the displayed price
  </Step>

  <Step title="Save">
    Click **Connect** to complete the integration
  </Step>
</Steps>

Once enabled, PayNext calculates and collects US sales tax automatically. See [Automatic tax collection](/guides/platform/tax) for details on how tax calculation works.

## Testing

Use your Numeral `sk_test_...` key in PayNext Sandbox. Test transactions don't incur charges or trigger tax filing.

<Tip>
  Test with addresses from different US states to verify tax rates are calculated correctly for various jurisdictions.
</Tip>