GST

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://www.instantpay.in/ws/utilities/banks' \
--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 /ws/utilities/banks HTTP/1.1
Host: www.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

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

String

Live/Sandbox

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!