Compute TCS

POST/api/v1/tcs/compute

Computes Tax Collected at Source (TCS) for LRS (Liberalised Remittance Scheme) cross-border orders.

When to use:

Amount exceeds TCS slab threshold — The transaction amount is greater than the configured slab threshold (e.g., ₹10,00,000) for the current financial year.
Customer declares TCS voluntarily (is_tcs_declared: true) — The customer has intentionally declared TCS even when the current transaction amount is below the slab threshold. This is applicable when the customer has already exceeded the slab threshold across multiple transactions in the current financial year.

Note: This API is only applicable for orders with flow_type: LRS. It will return an error for non-LRS purpose code orders.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Request Body

Name	Type	Description
`order_id`	`string`required	The order ID for which TCS needs to be computed. Must be a valid cross-border order belonging to the merchant.
`amount`	`object`required	The amount on which TCS should be calculated.
`value`	`integer`required	Amount in paisa (smallest currency unit). Must be greater than 0.
`currency`	`string`required	Currency code. Must be INR.
`is_tcs_declared`	`boolean`	Set to true when the customer voluntarily declares TCS. When true, the full amount is taxed at the applicable TCS rate, bypassing the threshold deduction. Defaults to false.

Response

Name	Type	Description
`tcs_applicable`	`boolean`	Whether TCS is applicable for this transaction.
`tcs_rate`	`string`	The TCS rate applied (percentage).
`original_amount`	`object`	The original amount passed in the request.
`value`	`integer`	Amount in paisa.
`currency`	`string`	Currency code.
`computed_amount`	`object`	The total amount including TCS (original + TCS). Same as original when TCS is not applicable.
`value`	`integer`	Total amount in paisa (original + TCS).
`currency`	`string`	Currency code.
`slab_id`	`string`	Identifier of the matched TCS slab.
`is_flat_rate`	`boolean`	Whether the slab uses a flat rate or threshold-based rate.
`flat_rate`	`string`	The flat rate value (present only if is_flat_rate is true).
`financial_year`	`string`	The current financial year (Indian FY April–March).
`breakdown`	`object`	Detailed breakdown of the TCS computation.
`amount`	`object`	The base amount used for TCS calculation.
`tcs`	`object`	The TCS amount computed.

Status Codes

`200`	TCS computation result.
`400`	Validation error.
`401`
`404`	Order not found.
`500`

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/v1/tcs/compute \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "v1-260514071718-aa-XqVzeA",
  "amount": {
    "value": 100000,
    "currency": "INR"
  },
  "is_tcs_declared": true
}'

Run this request

Bearer token

Request body (JSON)

200 OK

{
  "tcs_applicable": true,
  "tcs_rate": "20.00",
  "original_amount": {
    "value": 100000,
    "currency": "INR"
  },
  "computed_amount": {
    "value": 120000,
    "currency": "INR"
  },
  "slab_id": "slab-lrs-2026-27",
  "is_flat_rate": false,
  "financial_year": "2026-27",
  "breakdown": {
    "amount": {
      "value": 100000,
      "currency": "INR"
    },
    "tcs": {
      "value": 20000,
      "currency": "INR"
    }
  }
}