Skip to main content
POST
Create a New Tax Setting

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
taxName
string
required
Example:

"Stamp duty"

taxType
enum<string>
required
Available options:
flat,
percentage
Example:

"flat"

rate
number
required
Example:

100

currency
string
required
Example:

"NGN"

regionId
integer
required
Example:

1

capAmount
number
Example:

2000

thresholdAmount
number
Example:

0

Response

201 - application/json

Tax setting created successfully.

id
integer
Example:

12

taxName
string
Example:

"VAT"

taxType
enum<string>
Available options:
flat,
percentage
Example:

"percentage"

rate
number<float>
Example:

7.5

currency
string
Example:

"NGN"

capAmount
number<float>
Example:

2000

thresholdAmount
number<float>
Example:

0

regionId
integer
Example:

1

regionName
string
Example:

"Nigeria"

merchantName
string
Example:

"DEE LLC"

status
enum<string>
Available options:
active,
inactive
Example:

"active"

template
boolean
Example:

false

templateId
integer
Example:

1