Configure payment and tax

commercetools Checkout

Building a checkout process from scratch takes a lot of time and effort. commercetools Checkout works with commercetools Composable Commerce and is integrated in commercetools Frontend. You just need to configure a few settings for payment and tax, and you are ready to go.


To view the checkout configuration settings, open the Merchant Center and select commercetools Checkout from the main menu.

Payments are handled by payment connectors, which connect to different payment service providers (PSPs).

We've pre-installed a mock payment connector that can help you test your checkout process. The mock payment connector requires minimal configuration and doesn't connect to any PSP. When you're ready, you can create and enable one or more payment connector(s) from our list of supported Payment Providers.

Mock payment details

To simulate payments during the checkout process using the mock payment connector, enter the following credit card details.

  • Card number:
    • Visa: 4111111111111111
    • Mastercard: 5555555555554444
    • American Express: 341925950237632
  • Expiry date: any future date
  • CVC/CVV: any three or four digit-number
  • Name on card: any text

These details are for simulation purposes only; no payment is actually made.


Calculating tax is a core part of any commerce system. Taxes can be calculated either by Composable Commerce or by a third-party tax calculation service. The option you choose generally depends on how complex the taxes are in the areas where you sell your products. For example, in the United States or Canada, each state or province may have different tax rates. In addition, tax rates can differ depending on the products being sold. In these cases, merchants typically choose to use a third-party tax calculation service.

Configure taxes

To view and manage your Project's tax configuration, do the following:

  1. Open the Merchant Center.
  2. Go to Settings > Project settings.
  3. Select the Taxes tab.

In the Taxes tab, you can configure Tax Categories, which store individual Tax Rates like VAT or sales tax. When you define a Tax Rate, you have the option of including the tax in the price of each product. To do this, select the Included in price checkbox. However, if you're using a third-party tax calculation service, be sure to leave this option unselected to ensure prices are properly displayed. To learn more about configuring taxes in your Project, see our Taxes guide.

Third-party tax calculation

If you decide to calculate taxes externally using a third-party tax calculation service, we recommend that you select one from our Integration Marketplace. The marketplace provides pre-configured integrations for use in your Project. Once you've chosen an external service, see our Tax integration guide to get set up.

Further reading

To learn more about how the overall checkout process works with Composable Commerce, we recommend that you read our Checkout best practices guide.