PApaypal
Taxes

Create a tax

Creates a new tax that can be applied to invoices

post/taxes

Request

Request body

namestring required

Name of the tax

ratestring required

The percentage rate of the tax applied to transactions. A decimal amount from 0.01 to 100.00 inclusive, always with exactly two decimal places, no leading zeros except 0.xx.

descriptionstring

Detailed description of the tax for internal reference

codestring required

Unique code used to identify the tax. Must contain only alphanumeric characters, underscores, and hyphens.

Example request

{
  "name": "TVA",
  "rate": "20.00",
  "description": "French standard VAT",
  "code": "standard_vat"
}

Response

Successfully created tax

namestring required

Name of the tax

ratestring

The percentage rate of the tax applied to transactions. A decimal amount from 0.01 to 100.00 inclusive, always with exactly two decimal places, no leading zeros except 0.xx.

descriptionstring

Detailed description of the tax for internal reference

codestring

Unique code used to identify the tax. Must contain only alphanumeric characters, underscores, and hyphens.

idstring uuid

Unique identifier of the tax

created_atstring date-time

The effective start date of the subscription; can be past, current, or future. Date must be provided in ISO 8601 format

Example response

{
  "name": "TVA",
  "rate": "20.00",
  "description": "French standard VAT",
  "code": "standard_vat",
  "id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
  "created_at": "2025-06-01T00:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.