Header Parameters

Name	Type	Description	Mandatory (M) , Optional (O)	Mandatory (M) , Optional (O)
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

Name	String	Description
mobileNumber	String	Mobile Number of the Remitter
otp	String	OTP received on Remitter Mobile
referenceKey	String	Reference Key received on Remitter Registration response

Sample Request

curl --location 'https://api.instantpay.in/fi/remit/out/domestic/v2/remitterRegistrationVerify' \
--header 'X-Ipay-Endpoint-Ip: 14.142.186.142' \
--header 'X-Ipay-Client-Id: YWY3OTAzYxxxxxxxxx+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 82e4755d7xxxxxxxxxxxxxxf87f3000aa5b56fc926d1' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Outlet-Id: 72762' \
--header 'Content-Type: application/json' \
--data '{
    "mobileNumber":"9876543210",
    "otp" : 704937,
    "referenceKey": "c2vt2c1C+65XaATXT1wifgyFeZuQEPpgGeMqTrmLwmy7RE4OryjqBYCkRsM767z4.v2.5538608139be2174-e6c6-49d2-a14e-aa2e9b360fba"
}'

POST /fi/remit/out/domestic/v2/remitterRegistrationVerify HTTP/1.1
Host: api.instantpay.in
X-Ipay-Endpoint-Ip: 14.142.186.142
X-Ipay-Client-Id: YWY3OTAxxxxxxxxxxxxIEcETrD5Yx+Q=
X-Ipay-Client-Secret: 82e4755d7c1xxxxxxxxxxxxxxx87f3000aa5b56fc926d1
X-Ipay-Auth-Code: 1
X-Ipay-Outlet-Id: 72762
Content-Type: application/json
Content-Length: 191

{
    "mobileNumber":"9876543210",
    "otp" : 704937,
    "referenceKey": "c2vt2c1C+65XaATXT1wifgyFeZuQEPpgGeMqTrmLwmy7RE4OryjqBYCkRsM767z4.v2.5538608139be2174-e6c6-49d2-a14e-aa2e9b360fba"
}

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": "KYC",
    "actcode": null,
    "status": "Mobile validated successfully please proceed for kyc",
    "data": {
        "validity": "2024-11-05 13:07:10",
        "referenceKey": "ZN+RGM7v9vPVKWgvbrGJUnX22Dg/+ctShTjoxGRtv5a8k0O4xI5uAKOzKwznsi7M.v2.67e7132dMjQzMjYxMjQzMTMyMjQ0ODcxNmUzNTM1MmU1NDc2NjI1OTY0NTg2ZTczNTg0ZjY4NTQ0NjYyNmUyZTU5MzQ2YTM2NjMzNzdhNjY1ODRiNzU0ZTUzNGEyZjU1MmU2YTU1NDk2MzY3NmIzOTdhNGE2NjUxNDk2Zjc5"
    },
    "timestamp": "2024-11-05 13:02:15",
    "ipay_uuid": "h0009d6a23d8-3022-4e48-b728-78f32d17c899-k7KDlTBRVqbo",
    "orderid": null,
    "environment": "LIVE",
    "internalCode": null
}