Tax Payment APIs

About

  • The TDS Payment APIs allow its users to pay taxes through a virtual account built on top of an escrow account.

Usecase

  • HRMS platforms can use these APIs to make TDS Payments on employee's salaries seamlessly
  • It can be easily integrated in the back office workflows, without any disruption in the current flow, to automate tax payments for your organization

Pay Tax

Endpoint

Used to make tax payment.

HTTP Method

Resource

Description

POST

/tax-payment/accounts/{account_number}/direct-tax

This API takes in tax payment-related details and returns tax payment challan, while paying your taxes to CBDT.

API EndpointAPI Endpoint

Request

  • This API takes Tax Payment Entity excluding Challan parameter as its Request body.
  • The payment_details parameter of the entity does not require you to mention transaction_id, bank_transaction_id and status parameter of Payment Details Entity.

Response

  • This API responds back Tax Payment Entity including Challan parameter which can be used to download tax payment challan pdf and also know other details.
  • The payment_details parameter of the TDS entity provides you with transaction_id, and the latest status of tax payment, bank_transaction_id is received only if the payment status is successful.
  • The transction_id can further be used in other APIs to fetch historical data.

Get Tax Payment

Endpoint

Used to fetch past Tax Payment

HTTP Method

Resource

Description

GET

/tax-payment/accounts/{account_number}/direct-tax/{tax_payment_id}

Returns past tax payment details.
This API can be used to fetch latest status of previous tax payments

API EndpointAPI Endpoint

Response

  • This API responds back Tax Payment Entity including Challan parameter which can be used to download tax payment challan pdf and also know other details.
  • The payment_details parameter of the Tax Payment entity provides you with the latest status of tax payment, bank_transaction_id is received only if the payment status is successful.

Fetch Challan

Endpoint

Used to download Tax payment challan after successful payment

HTTP Method

Resource

Description

GET

/tax-payment/accounts/{account_number}/direct-tax/{tax_payment_id}/challan

This API takes tax payment ID and returns Challan Entity which contains a signed URL to download challan pdf and other info.

API EndpointAPI Endpoint

Response

  • This API responds back Challan Entity which can be used to download tax payment challan pdf and also know other details.

Fetch Direct Tax Payments

Endpoint

Used to request to fetch all transactions done on an account

HTTP Method

Resource

Description

GET

/tax-payment/accounts/{account_number}/direct-tax

This API can be used to fetch all the tax payment transaction done a virtual payments account in a given time frame

API EndpointAPI Endpoint

Response


Tax Deduction at Source Entity

Param

Type

Description

Example

payer

Tax Payer Entity (required)

Tax Payer

payment_details

Payment Details Entity

Payment Details

tax_breakup

Tax Breakup Entity (required)

Tax Breakup

section_code

string (required)

Section under which the tax is deducted for deductee

Possible values

assessment_year

string (required)

Year in which income is earned (FY)+1

2022-23, 2023-24

amount

number (required)

Total amount to be paid

1000,200

challan

Challan Entity

Challan

failure_reasaon

string

failure reason in case of tax payment failure

tax payment failed due to insufficient balance.

Tax Payer Entity

Param

Type

Description

Example

tan

string (required)

TAN of deductor

PDES03028F

address

Address Entity (required)

Address

Address Entity

Param

Type

Description

Example

street

string (required)

Street of the company/LLP

701, Amarapali lake view

area

string (required)

Area of the company/LLP

Vastrapur

city

string (required)

City of the company/LLP

Ahmedabad

state

string (required)

State of the company/LLP

Gujarat

country

string (required)

Country of the company/LLP

India

postal_code

number (required)

Postal code of the company/LLP

380015

Payment Details Entity

Param

Type

Description

Example

description

string

Transaction description

TDS Payment for salary

transaction_id

string

Unique transaction id

58sdKG-12e4-5d58-8c4s5654sw6898

bank_transaction_id

string

Transaction Reference number from bank

2654316812

status

string

Represents Tax payment status

Created, Processing, Successful, Failed

notes

json object

Additional notes on transaction

{ "customer":"John",
"client":"quicko"}

mode

string

Payment Mode

RTGS,NEFT,UPI,IMPS

Tax Breakup Entity

Param

Type

Description

Example

basic_tax

number (required)

Tax amount

460

surcharge

number (required)

Surcharge amount

20

education_cess

number (required)

Education Cess amount

0

equlization_levy

number (required)

Equalization Levy amount

0

other_fee

number (required)

Other fee amount

0

interest_amount

number (required)

interest amount

0

other_amount

number (required)

Any other amount

500

penalty

Penalty Entity (required)

Penalty

Penalty Entity

Param

Type

Description

Example

code

string (required)

Applicable Penalty Code

amount

number (required)

Penalty Amount

20

Challan Entity

Param

Type

Description

Example

serial_number

string

Tax Payment Challan Serial Number

00001

bsr_code

string

Challan BSR code

6391230

download_url

string

Signed url to download challan pdf(valid only for 1 day)

https://www.example.com/challan

Supported section codes for TDS/TCS payments

Section Code for Payment

Description

Section

193

Interest on Securities

193

194

Dividend

194

195

Other sums payable to a nonresident

195

4BA

Certain income from units of a business trust

194LBA(a),194LBA(b),194LBA(c)

4DA

Payment in respect of life insurance policy

194DA

4EE

Payments in respect of Deposits under National Saving Schemes

194EE

4LA

Payment of Compensation on Acquisition of Certain Immovable property

194LA

4LB

Income by way of interest from infrastructure debt fund payable to a nonresident

194LB

4LC

Income by way of interest from specified Company payable to a nonresident

194LC

4LD

Interest on Rupee denominated bond of Company or Government Securities

194LD

6CA

Alcoholic liquor for human consumption

206C(1)

6CB

Timber obtained under forest lease

206C(1)

6CC

Timber obtained other than forest lease

206C(1)

6CD

Any other forest produce not being timber or tendu leaves

206C(1)

6CE

Scrap

206C(1)

6CF

Parking Lot

206C(1C)

6CG

Toll Plaza

206C(1C)

6CH

Mining and Quarrying

206C(1C)

6CI

Tendu Leaves

206C(1)

6CJ

Minerals

206C(1)

6CK

Bullion and Jewelry

206C(1D)

6DA

Income of specified fund from securities referred to in clause (a) of subsection (1) of section 115AD (other than interest income referred to in section 194LD)

196D

92A

Payment to Govt. Employees other than Union Govt. employees

192

92B

Payment of Employees other than Govt. Employees

192

94A

Interest other than Interest on Securities

194A

94B

Winning from lotteries and crossword puzzles

194B

94C

Payment of contractors and subcontractors

194C

94D

Insurance commission

194D

94E

Payments to nonresident Sportsmen/Sport Associations

194E

94F

Payments on account of Repurchase of Units by Mutual Funds of UTI

194F

94G

Commission, prize etc. on sale of Lottery tickets

194G

94H

Commission or Brokerage

194H

94I

Rent

194I(a),194I(b)

94J

Fees for Professional or Technical Services

194J(a),194J(b)

94K

Income Payable to a resident assessee in respect of units of a specified Mutual Fund or of the Units of the UTI

194K

94N

Payment of certain amounts in cash

194N

94P

Payment to Specified Senior Citizen

194P

94Q

Deduction of tax at source on payment of certain sum for purchase of goods

194Q

96A

Income in respect of Units of nonresidents

196A

96B

Payments in respect of Units to an Offshore Fund

196B

96C

Income from foreign currency Bonds or Shares of Indian Company payable to a nonresident

196C

96D

Income of Foreign Institutional investors from securities

196D

2AA

Payment of accumulated balance due to an employee

192A

LBB

Income in respect of units of investment fund

194LBB

6CL

TCS on sale of Motor vehicle

206C(1F)

6CM

TCS on sale in cash of any goods (other than bullion/jewelry)

206C(1D)

6CN

TCS on providing of any services (other than Ch-XVII-B)

206C(1H)

LBC

Income in respect of investment in securitization trust

194LBC

4IC

Payment under specified agreement

194IC

6CO

TCS on foreign remittance

206C(1G)

6CP

Remittance under LRS for educational loan taken from financial institution mentioned in section 80E

206C(1G)

6CQ

Remittance under LRS for purpose other than for purchase of overseas tour package or for educational loan taken from financial institution

206C(1G)

6CR

TCS on sale of Goods

206C(1H)

94O

TDS on Ecommerce transactions

194O

Tax Payment Failure Enums

failure_reason

Description

CANCELED

tax payment/transaction explicitly canceled by the user

SOURCE_UNAVAILABLE

tax payment/transaction failed due to downtime on the partner bank's end

INSUFFICIENT_FUNDS

tax payment/transaction failed due to insufficient funds in the virtual account

INVALID_TRANSACTION_AMOUNT

tax payment/transaction failed because expected and actual transaction amount mismatch

PAYMENT_METHOD_FAILED

tax payment failed because the user was not able to make payment from the UPI App


Did this page help you?