Hide the option to add tax and business information at checkout

What's new?

We added a new parameter to the Paddle.Checkout.open() method and Paddle.Initialize() methods that you can use to hide the option to add a tax number at checkout when working with Paddle.js:

settings object

Set general checkout settings.

showAddTaxId boolean or null

Whether the option to add a tax number is displayed at checkout. Defaults to true.

We also added a corresponding HTML data attribute:

data-show-add-tax-id boolean

Default: true

Whether the option to add a tax number is displayed at checkout. Defaults to true.

How it works

Paddle Checkout includes an "Add Tax Number" option to let customers enter a tax number. When clicked, Checkout prompts customer to enter their tax number, information about their business, and full address. If you don't work with businesses, you might like to hide this option.

The new showAddTaxId settings parameter and data-show-add-tax-id HTML data attribute lets you hide the option to add tax number and business information at checkout.

You can pass settings for opened checkouts using either Paddle.Checkout.open() or Paddle.Initialize(). Settings passed to Paddle.Initialize() are default settings, applied to all checkouts opened on a page.

This change removes the option for customers to apply a tax number and business information themselves, but you can still prefill business information when opening a checkout.

Examples

This example includes the settings object as part of the checkout open method. showAddTaxId is set to false, meaning the option to "Add tax number" is hidden for the opened checkout.

The settings passed here only apply to the opened checkout.

New showAddTaxId parameter

var itemsList = [
  {
    priceId: 'pri_01gm81eqze2vmmvhpjg13bfeqg',
    quantity: 1
  },
  {
    priceId: 'pri_01gm82kny0ad1tk358gxmsq87m',
    quantity: 1
  }
];

Paddle.Checkout.open({
  settings: {
    displayMode: "overlay",
    theme: "light",
    locale: "en",
    showAddTaxId: "false"
  },
  items: itemsList,
});

This example sets default checkout settings for all checkouts opened on a page. showAddTaxId is set to false, meaning the option to "Add tax number" is hidden for all opened checkouts on the page.

New showAddTaxId parameter

Paddle.Initialize({
  token: 'live_7d279f61a3499fed520f7cd8c08',
  checkout: {
    settings: {
      displayMode: "overlay",
      theme: "light",
      locale: "en",
      showAddTaxId: "false"
    }
  }
});

This example shows hiding the option to add a tax number passed as an HTML data attribute against a Paddle Checkout element.

It includes checkout settings and items.

New HTML data attribute

<a href='#'
  class='paddle_button'
  data-display-mode='overlay'
  data-theme='light'
  data-locale='en'
  data-allow-logout='false'
  data-items='[
    {
      "priceId": "pri_01gm81eqze2vmmvhpjg13bfeqg",
      "quantity": 1
    },
    {
      "priceId": "pri_01gm82kny0ad1tk358gxmsq87m",
      "quantity": 1
    }
  ]'
  data-show-add-tax-id='false'
>
  Buy now
</a>

Next steps

This change is live in Paddle.js now, so you can start using showAddTaxId or data-show-add-tax-id when you're ready.

You don't need to do anything to get the latest version of Paddle.js — we serve the latest version automatically.

Entity	Field	Change	Type
Paddle.Checkout.open()	`showAddTaxId`	+ Added	Paddle.js param
Hide the add tax ID option at checkout.
HTML data attributes	`data-show-add-tax-id`	+ Added	Paddle.js param