OTP Validation

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

Request Parameters

Name	Type	Description
otpReference	String	Same as received in API response
otp	string	Received on Remitter Number

Sample Request

curl --location --request POST 'https://api.instantpay.in/fi/remit/out/domestic/otpVerification' \
--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 'X-Ipay-Outlet-Id: {{outletId}}' \
--data-raw '{
    "otpReference": "6c454f306c786b44397254334c323138586c4576616f7647517766416c7274724f78545a632f4c326d3364537a744d4247786b4b4e644359614e6b5253534d337a78344e7a364870354d69664573352b42454e38517871364145355476767266364a2b33546168555343567975696e347a36766e33536b3876454f4d6a577831794741436b79776a63556a6d354969424b7752765979532b46592b78636c304359412f6345493142374c5759464c51454637565379565658386c4445787a7367686e72482b6d316d35313672386a6e71533354413936755067385558374b62556b4e46775a336256524f343d",
    "otp": "876341"
}'

POST /fi/remit/out/domestic/otpVerification 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}}
X-Ipay-Outlet-Id:{{outletId}}
Content-Type: application/json

{
    "otpReference": "6c454f306c786b44397254334c323138586c4576616f7647517766416c7274724f78545a632f4c326d3364537a744d4247786b4b4e644359614e6b5253534d337a78344e7a364870354d69664573352b42454e38517871364145355476767266364a2b33546168555343567975696e347a36766e33536b3876454f4d6a577831794741436b79776a63556a6d354969424b7752765979532b46592b78636c304359412f6345493142374c5759464c51454637565379565658386c4445787a7367686e72482b6d316d35313672386a6e71533354413936755067385558374b62556b4e46775a336256524f343d",
    "otp": "876341"
}

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": "TXN",
    "actcode": null,
    "status": "Success",
    "data": {
        "mobile": "7428585742",
        "firstName": "Sample First Name",
        "lastName": "Sample Last Name",
        "address": "Samle Address",
        "city": "City Name",
        "state": "State Name",
        "pincode": "110044",
        "limitConsumed": "25000.00",
        "limitAvailable": "0.00",
        "limitIncreaseOffer": false,
        "beneficiaries": [
            {
                "id": "d580b9d86ec9f86cb26ce0cc4ed80726",
                "name": "Sample Full Name",
                "account": "7770007428585742",
                "ifsc": "YESB0CMSNOC",
                "bank": "Yes Bank"
            }
        ]
    },
    "timestamp": "2022-07-28 10:48:33",
    "ipay_uuid": "h00696e24438-a8bd-7e08dfddb672-fab3c8714750",
    "orderid": null,
    "environment": "LIVE",
}