Request Parameters

Parameters Name	Requirement	Description
biometricData.rdsId	Mandatory	Returned by RD Service when using biometric authentication. RD Service Id.
biometricData.rdsVer	Mandatory	Returned by RD Service when using biometric authentication. RD Service version.
biometricData.ci	Mandatory	Returned by RD Service when using biometric authentication. Public key certificate identifier of UIDAI using which skey was encrypted.
biometricData.dc	Mandatory	Returned by RD Service when using biometric authentication. Registered Device code.
biometricData.dpId	Mandatory	Returned by RD Service when using biometric authentication. Device provider Id.
biometricData.hmac	Mandatory	Returned by RD Service when using biometric authentication. SHA -256 Hash of PID XML and then encrypted and base 64 encoded
biometricData.mc	Mandatory	Returned by RD Service when using biometric authentication. encrypted registered device public key certificate
biometricData.mi	Mandatory	Returned by RD Service when using biometric authentication. RD model Id.
biometricData.pidData	Mandatory	base-64 encoded encrypted pid block.
biometricData.sessionKey	Mandatory	Returned by RD Service when using biometric authentication. AES session key generated dynamically for every txn

Sample Request

POST /fi/remit/out/nepal/outletEkycProcess HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1
X-Ipay-Endpoint-Ip: 125.0.0.1
X-Ipay-Outlet-Id: 72762
Content-Type: application/json
Content-Length: 473

{
    "biometricData": {
        "rdsId":"MANTRA.WIN.001",
        "rdsVer":"1.0.6",
        "ci": "20250929",
        "dc": "04e901f3-e07b-4ac2-a93e-840dff421a49",
        "dpId": "MANTRA.MSIPL",
        "hmac": "ebABrIPUq26YpSSKPE3WRKuRmudQOyyEABdw7AxoQs1hvdKG6asEQifO1ARZcnv/",
        "mc": "",
        "mi": "MFS100",
        "pidData": "",
        "sessionKey": "="
    },
}

curl --location 'http://api.instantpay.in/fi/remit/out/nepal/outletEkycProcess' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1' \
--header 'X-Ipay-Endpoint-Ip: 125.0.0.1' \
--header 'X-Ipay-Outlet-Id: 72762' \
--header 'Content-Type: application/json' \
--data '{
    "biometricData": {
        "rdsId":"MANTRA.WIN.001",
        "rdsVer":"1.0.6",
        "ci": "20250929",
        "dc": "04e901f3-e07b-4ac2-a93e-840dff421a49",
        "dpId": "MANTRA.MSIPL",
        "hmac": "ebABrIPUq26YpSSKPE3WRKuRmudQOyyEABdw7AxoQs1hvdKG6asEQifO1ARZcnv/",
        "mc": "",
        "mi": "MFS100",
        "pidData": "",
        "sessionKey": "="
    },
}'

Response Parameter

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 )
enviroment	String	Live/Sandbox

📘
Info :
For API Headers Click Here

200200

400400