Header Parameters

Name	Type	Description	Mandatory (M) , Optional (O)	Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-Code	String	Auth Code is "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-Endpoint-Ip	String	End Customer IP Address	M	N

Request Parameter for Bank

Parameter Name	Type	Requirement	Description
payer	Array	Mandatory	Payer details
payer.bankProfileId	String	Mandatory	Unique Bank Profile Id
payer.accountNumber	String	Mandatory	Account number of the Connected Bank
beneficiaryType	String	Mandatory	It will be OTHERS or AXIS

Sample Request for Bank

curl --location --globoff '{{host}}/payments/payout/fetchBeneficiary' \
--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 'Content-Type: application/json' \
--data '{
    "payer": {
        "bankProfileId": "4295906",
        "accountNumber": "921020049249146"
    },
    "beneficiaryType":"OTHERS"
}'

POST /payments/payout/fetchBeneficiary HTTP/1.1
Host: {{host}}
-Ipay-Auth-Code: {{authCode}}
X-Ipay-Client-Id: {{clientId}}
X-Ipay-Client-Secret: {{clientSecret}}
X-Ipay-Endpoint-Ip: {{endPointIP}}
Content-Type: application/json
Content-Length: 141

{
    "payer": {
        "bankProfileId": "4295906",
        "accountNumber": "921020049249146"
    },
    "beneficiaryType":"OTHERS"
}

Response Parameter for bank

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	Response 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/Sandbox
internalCode	String	It will be null