Tax Payments

Pay all your direct and indirect taxes using this service.

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code -1 (Fixed)MY
X-Ipay-Client-IdStringUnique Client IDMY
X-Ipay-Client-SecretStringUnique secret keyMY
X-Ipay-Endpoint-IpStringEnd Customer IP AddressMN

Request Parameters

Parameter NameTypeRequirementDescription
taxTypeStringMandatoryGST (fixed)
dataArrayMandatorydata details
data.cpinStringMandatoryIssued at the time generating GST tax challan by online (14 digit).
amountStringMandatoryGST Challan amount
latitudeStringMandatoryEnd Customer Latitude.
longitutdeStringMandatoryEnd Customer Longitude.
externalRefStringMandatoryYour unique transaction Id
remarksStringMandatoryGST Remarks
alertEmailsStringMandatoryEnd 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":"01**********54"
    },
    "amount" :"1.00",
    "latitude" : "28.6441",
    "longitude" : "77.21711",
    "externalRef" : "PREPROD1",
    "remarks":"TEST GST PAYMENT",
    "alertEmails":[
        "d****[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":"01**********54"
    },
    "amount" :"1.00",
    "latitude" : "28.6441",
    "longitude" : "77.21711",
    "externalRef" : "PREPROD1",
    "remarks":"TEST GST PAYMENT",
    "alertEmails":[
        "d****[email protected]"
    ]        
}

Response Parameters

NameTypeDescription
statuscodeStringInstantPay Status Code
actcodeStringAction Code
statusStringStatus message
dataArrayResponse Data (If Present)
timestampStringResponse time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id ( If transaction otherwise it is null )
environmentArrayLive/Sandbox
internalCodeStringInternal Message

Sample Response

{
        "statuscode": "TXN",
        "actcode": null,
        "status": "Transaction Successful",
        "data": {
            "externalRef": "PROD1",
            "poolReferenceId": "122**********TVWXW",
            "txnValue": "10.00",
            "txnReferenceId": "00",
            "pool": {
                "account": "99******46",
                "openingBal": "3722.21",
                "mode": "DR",
                "amount": "10.00",
                "closingBal": "3712.21"
            },
            "payer": {
                "account": "99******46",
                "name": "MUKESH ENTERPRISES"
            },
            "payee": {
                "account": "220********014",
                "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.

Language
Click Try It! to start a request and see the response here!