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": "8****1"
}'
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": "8****1"
}

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": "74******75",
        "firstName": "Ma****a",
        "lastName": "K****i",
        "address": " **********",
        "city": "",
        "state": "D***I",
        "pincode": "1****4",
        "limitConsumed": "25000.00",
        "limitAvailable": "0.00",
        "limitIncreaseOffer": false,
        "beneficiaries": [
            {
                "id": "bb2cfc61****************63b8",
                "name": "AJ**********A",
                "account": "04*********01",
                "ifsc": "UT*******48",
                "bank": "A******nk"
            }
        ]
    },
    "timestamp": "2022-07-28 10:48:33",
    "ipay_uuid": "h00696e24438-***************-fab3c8714750",
    "orderid": null,
    "environment": "LIVE",
}
Language
Click Try It! to start a request and see the response here!