Pay all your direct and indirect taxes using this service. Streamline your tax payments with Instantpay's Tax Payments API solution. This service lets you conveniently pay all your direct and indirect taxes, ensuring compliance and efficiency in your financial transactions.
Whether you're handling personal or business taxes, this API offers a secure and straightforward solution, making the tax payment process hassle-free and reducing the burden of manual transactions.
Header Parameters
| Name | Type | Description | Mandatory (M) , Optional (O) | Provided by INSTANTPAY (Y/N) |
|---|---|---|---|---|
| X-Ipay-Auth-Code | String | Auth Code -1 (Fixed) | M | Y |
| X-Ipay-Client-Id | String | Unique Client ID | M | Y |
| X-Ipay-Client-Secret | String | Unique secret key | M | Y |
| X-Ipay-Endpoint-Ip | String | End Customer IP Address | M | N |
Request Parameters
| Parameter Name | Type | Requirement | Description |
|---|---|---|---|
| taxType | String | Mandatory | GST (fixed) |
| data | Array | Mandatory | data details |
| data.cpin | String | Mandatory | Issued at the time generating GST tax challan by online (14 digit). |
| amount | String | Mandatory | GST Challan amount |
| latitude | String | Mandatory | End Customer Latitude. |
| longitutde | String | Mandatory | End Customer Longitude. |
| externalRef | String | Mandatory | Your unique transaction Id |
| remarks | String | Mandatory | GST Remarks |
| alertEmails | String | Mandatory | End User email for alert |
Sample Request
curl --location --request POST 'https://api.instantpay.in/tax/payments' \
--header 'Content-Type: application/json' \
--header 'X-Ipay-Auth-Code: {{authCode}}' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{clientSecret}}' \
--header 'X-Ipay-Endpoint-Ip: {{endPointIP}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"taxType":"GST",
"data":{
"cpin":"017439876554"
},
"amount" :"1.00",
"latitude" : "28.6441",
"longitude" : "77.21711",
"externalRef" : "PREPROD1",
"remarks":"TEST GST PAYMENT",
"alertEmails":[
"[email protected]"
]
}'
POST /tax/payments HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json
{
"taxType":"GST",
"data":{
"cpin":"017439876554"
},
"amount" :"1.00",
"latitude" : "28.6441",
"longitude" : "77.21711",
"externalRef" : "PREPROD1",
"remarks":"TEST GST PAYMENT",
"alertEmails":[
"[email protected]"
]
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| statuscode | String | InstantPay Status Code |
| actcode | String | Action Code |
| status | String | Status message |
| data | Array | Response Data (If Present) |
| timestamp | String | Response time (YYYY-MM-DD HH:II:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id ( If transaction otherwise it is null ) |
| environment | Array | Live/Sandbox |
| internalCode | String | Internal Message |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"externalRef": "PROD1",
"poolReferenceId": "1231214070644TLWAP",
"txnValue": "10.00",
"txnReferenceId": "00",
"pool": {
"account": "7428585742",
"openingBal": "3722.21",
"mode": "DR",
"amount": "10.00",
"closingBal": "3712.21"
},
"payer": {
"account": "7428585742",
"name": "Instantpay India Limited"
},
"payee": {
"account": "0174398765544",
"name": "Sample Name"
}
},
"timestamp": "2022-04-02 09:45:52",
"ipay_uuid": "h00595f6d0a7-7fc3-4dfc-8c9b-50457ba29eca",
"orderid": "1220402094551TVWXW",
"environment": "LIVE",
"internalCode": "Request submitted to bank"
}
Note :
1 - Latitude and Longitude must be represented in degrees with 4 digits after decimal.
2- externalRef must be unique and in alpha numeric characters.
3- Remarks should be in alphabet and it can be of maximum 20 characters.
4- Purpose are Case Sensitive.
Info :
Click Here to know how to get the Credentials.