Businesses have to pay
Overview
Pay your taxes through this API. This includes self-assessment tax, advance tax, TDS & TCS payments.
Problem
Solution
Endpoint
HTTP Method | Resource |
---|---|
POST | /tax-payment/accounts/{account_number}/direct-tax |
Request
Path Parameter
Param | Type | Description | Example |
---|---|---|---|
account_number | string | Virtual bank account number from which you want to make the tax payment. | HEY564578321596 |
Body
You need to pass the Tax Payment Entity excluding the challan entity.
The
entity
will change depending on the type of tax payment. Refer to the Sample CURL requests below.
Sample CURL
curl --request POST \
--url https://api.sandbox.co.in/tax-payment/accounts/HEY564578321596/direct-tax \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'x-api-key: xxxxxxxxxxxx' \
--data '
{
"@entity": "self_assessment_tax",
"payer": {
"@entity": "tax_payer",
"pan": "AB****5689",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"notes": {}
},
"tax_breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount":0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11C",
"amount": 100
}
},
"assessment_year": "2022-23",
"amount": 600
}
'
curl --request POST \
--url https://api.sandbox.co.in/tax-payment/accounts/HEY564578321596/direct-tax \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'x-api-key: xxxxxxxxxxxx' \
--data '
{
"@entity": "tax_deducted_at_source",
"payer": {
"@entity": "tax_payer",
"tan": "AB****568Q",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"notes": {}
},
"tax_breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount":0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11B",
"amount": 100
}
},
"deductee_category":"Non-Company",
"section_code": "194",
"assessment_year": "2021-22",
"amount": 600
}
'
curl --request POST \
--url https://api.sandbox.co.in/tax-payment/accounts/HEY564578321596/direct-tax \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'x-api-key: xxxxxxxxxxxx' \
--data '
{
"@entity": "advance_tax",
"payer": {
"@entity": "tax_payer",
"pan": "AB****5689",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"notes": {}
},
"tax_breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount":0,
"other_amount": 0,
},
"financial_year": "2021-22",
"amount": 600
}
'
curl --request POST \
--url https://api.sandbox.co.in/tax-payment/accounts/HEY564578321596/direct-tax \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'x-api-key: xxxxxxxxxxxx' \
--data '
{
"@entity": "tax_collected_at_source",
"payer": {
"@entity": "tax_payer",
"tan": "AB****568Q",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"notes": {}
},
"tax_breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount":0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11B",
"amount": 100
}
},
"deductee_category":"Non-Company",
"section_code": "6CA",
"assessment_year": "2021-22",
"amount": 600
}
'
Test Environment Not Available
Response
This API Responds with the Tax Payment Entity. An example response is shown below.
{
"code": 200,
"timestamp": 1631095323168,
"transaction_id": "8831d466-6fe7-48ed-b478-7d1cb4e92572",
"data": {
"@entity": "self_assessment_tax",
"id": "1271d411-6ae7-48cf-b478-8d1bb4f78523",
"payer": {
"@entity": "tax_payer",
"pan": "AB****5689",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"transaction_id": "58sdKG-12e4-5d58-8c4s5654sw6898",
"status": "Created",
"notes": {}
},
"breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount": 0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11C",
"amount": 100
}
},
"assessment_year": "2022-23",
"amount": 600,
"created_at": 1652177371340,
"updated_at": 1652177371340
}
}
{
"code": 200,
"timestamp": 1631095323168,
"transaction_id": "8831d466-6fe7-48ed-b478-7d1cb4e92572",
"data": {
"@entity": "tax_deducted_at_source",
"id": "5271d411-6ae7-48cf-b478-7d1bb4f78743",
"payer": {
"@entity": "tax_payer",
"tan": "AB****568Q",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"transaction_id": "58sdKG-12e4-5d58-8c4s5654sw6898",
"status": "Created",
"notes": {}
},
"breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount": 0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11NC",
"amount": 100
}
},
"deductee_catogary": "Non-Company",
"section_code": "194",
"assessment_year": "2021-22",
"amount": 600,
"created_at": 1652177371340,
"updated_at": 1652177371340
}
}
{
"code": 200,
"timestamp": 1631095323168,
"transaction_id": "8831d466-6fe7-48ed-b478-7d1cb4e92572",
"data": {
"@entity": "advance_tax",
"id": "1271d411-6ae7-48cf-b478-8d1bb4f78523",
"payer": {
"@entity": "tax_payer",
"pan": "AB****5689",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"transaction_id": "58sdKG-12e4-5d58-8c4s5654sw6898",
"status": "Created",
"notes": {}
},
"breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount": 0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11C",
"amount": 100
}
},
"financial_year": "2021-22",
"amount": 600,
"created_at": 1652177371340,
"updated_at": 1652177371340
}
}
{
"code": 200,
"timestamp": 1631095323168,
"transaction_id": "8831d466-6fe7-48ed-b478-7d1cb4e92572",
"data": {
"@entity": "tax_collected_at_source",
"id": "5271d411-6ae7-48cf-b478-7d1bb4f78743",
"payer": {
"@entity": "tax_payer",
"tan": "AB****568Q",
"address": {
"@entity": "address",
"street": "1, ABC Lakeview Tower",
"area": "Vastrapur",
"city": "Ahmedabad",
"state": "GUJARAT",
"country": "India",
"postal_code": "380015"
}
},
"payment_details": {
"@entity": "payment_details",
"description": "Test Transaction",
"transaction_id": "58sdKG-12e4-5d58-8c4s5654sw6898",
"status": "Created",
"notes": {}
},
"breakup": {
"@entity": "breakup",
"basic_tax": 500,
"surcharge": 0,
"education_cess": 0,
"equlization_levy": 0,
"other_fee": 0,
"interest_amount": 0,
"other_amount": 0,
"penalty": {
"@entity": "tax_penalty",
"code": "11NC",
"amount": 100
}
},
"deductee_catogary": "Non-Company",
"section_code": "194",
"assessment_year": "2021-22",
"amount": 600,
"created_at": 1652177371340,
"updated_at": 1652177371340
}
}