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 Client Secret	M	Y
X-Ipay-Endpoint-Ip	String	End Customer IP Address	M	Y

Request Parameters

Name	Type	Requirement	Description
linkId	String	Mandatory	Generated link id of the payment transactions.

Sample Request

curl --location 'https://api.instantpay.in/payments/payout/link/notify' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825' \
--header 'X-Ipay-Endpoint-Ip: 125.0.0.1' \
--header 'Content-Type: application/json' \
--data '{
    "linkId" : "657aa9841b8d3897ff0a84fb"
}'

POST /payments/payout/link/notify HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 125.0.0.1
Content-Type: application/json
Content-Length: 45

{
    "linkId" : "657aa9841b8d3897ff0a84fb"
}

Response Parameters

Parameter Name	Type	Description
statuscode	String	InstantPay StatusCode
actcode	String	Action Code
status	String	Status message
data	String	Response Data(if Present)
timestamp	String	Response time(YYYY-MM-DD HH:\|\|:SS)
ipay_uuid	String	Request reference number
orderid	String	Transaction Id(if transaction otherwise it is null)
environment	String	Live/Sandbox
internalCode	String	it will be null

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Notification Link Sent To *******742 and ******@instantpay.in",
    "data": null,
    "timestamp": "2023-12-14 15:27:40",
    "ipay_uuid": "h0009ad88809-ebd1-49ef-80cf-d2686d11072a-lcvrH7edHrIt",
    "orderid": null,
    "environment": "PRODUCTION",
    "internalCode": null
}