Chapter 2. Adding VAT rate on billing

API providers who charge their customers for using their API service often need to charge the tax as well. This article will explain how 3scale billing system supports VAT.

If you have Billing feature enabled, the steps to add VAT rates are as follows:

  1. From the Admin Portal, go to Audience > Accounts > Fields Definitions
  2. Then in the "Account" object click "Create" on the right hand side to add a field
  3. From the "new field" drop down select "vat_rate"
vat value

Either you can allow developers to set their own VAT rate, or alternatively you can set the VAT rate for them. If you choose the latter you have the following options:

  • From your admin portal, going to a given account and editing the VAT field

    edit vat
  • From the Account Management API, using the Account Update endpoint. If you want to update several accounts you will have to get them first using the Account List endpoint and then iterate over them updating the field. This could be combined into an automated flow using Webhooks to trigger your update requests when the Account is created or modified.

VAT rate will be calculated and reflected in invoices.