Overview

Pay your taxes through this API. This includes self-assessment tax, advance tax, TDS & TCS payments.

Pay Tax API Workflow

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
  }
}

Pay Tax

Overview

Problem

Solution

Endpoint

Request

Path Parameter

Body

📘
The `entity` will change depending on the type of tax payment. Refer to the Sample CURL requests below.

❗️
Test Environment Not Available

Response

Overview

Problem

Solution

Endpoint

Request

Path Parameter

Body

📘The entity will change depending on the type of tax payment. Refer to the Sample CURL requests below.

❗️Test Environment Not Available

Response

📘
The `entity` will change depending on the type of tax payment. Refer to the Sample CURL requests below.

❗️
Test Environment Not Available