Headers 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-Outlet-Id	String	Merchant unique ID	M	Y
X-Ipay-Endpoint-Ip	String	End Customer IP Address	M	N

Request Parameters

Parameters	Type	Description
remitterMobileNumber	String	Remitter Mobile Number
beneficiaryId	String	Beneficiary ID

Sample Request

curl --location 'https://api.instantpay.in/fi/remit/out/domestic/v2/beneficiaryDelete' \
--header 'X-Ipay-Endpoint-Ip: 49.249.72.66' \
--header 'X-Ipay-Client-Id: {{clientId}}' \
--header 'X-Ipay-Client-Secret: {{{clientSecret}}' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'Content-Type: application/json' \
--data '{
    "remitterMobileNumber": "9876543210",
    "beneficiaryId": "80bdd0f178f21016e4711765770dc91c"
}'

POST /fi/remit/out/domestic/v2/beneficiaryDelete HTTP/1.1
Host: api.instantpay.in
X-Ipay-Ipin: {{iPin}}
X-Ipay-Endpoint-Ip: 49.249.72.66
X-Ipay-Request-Hash: {{hashCode}}
X-Ipay-Request-Timestamp: {{xTimestamp}}
X-Ipay-Hash-Check: OFF
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Auth-Code: 1
User-Agent: {{userAgent}}
Content-Type: application/json
Content-Length: 101

{
    "remitterMobileNumber": "9835799007",
    "beneficiaryId": "80bdd0f178f21016e4711765770dc91c"
}

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	Current 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

Sample Response

{
    "statuscode": "OTP",
    "actcode": null,
    "status": "OTP Successfully sent",
    "data": {
        "beneficiaryId": "80bdd0f178f21016e4711765770dc91c",
        "validity": "2025-12-16 17:49:19",
        "referenceKey": "TcTkLK9J+Oyz1rpbTDbDrHGZ7rFtOOpQY4lYINGnPlpUGn2u6WludIqrhCzb7O8G"
    },
    "timestamp": "2025-12-16 17:34:19",
    "ipay_uuid": "h000a09b40b3-a510-4feb-ae21-86c5f2c83779-4DbyTgDsBBL0",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}