post https://api.instantpay.in/tax/payments
Pay all your direct and indirect taxes using this service.
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.