Pine LabsDOCS
Create Account

API Playground

Test Pine Labs API endpoints with real requests. All endpoints are loaded dynamically from the OpenAPI specification.

Compute TCS

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.

POSThttps://pluraluat.v2.pinepg.in/api/v1/tcs/compute
Required
Request Body (editable JSON)
Request Body Schemarequired
FieldDetails
order_id
stringrequired

The order ID for which TCS needs to be computed. Must be a valid cross-border order belonging to the merchant.

amount
objectrequired2 nested fields

The amount on which TCS should be calculated.

value
integerrequiredint64

Amount in paisa (smallest currency unit). Must be greater than 0.

currency
stringrequired

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.

Constraints
Default value: false