post https://api.instantpay.in/fi/remit/out/nepal/fundTransfer
This API is used to initiate the transactions.
Request Parameters
| Parameters | Requirement | Description |
|---|---|---|
| remitterMobile | Mandatory | Mobile Number of the Remitter |
| beneficiaryId | Mandatory | Beneficiary Id |
| transferAmount | Mandatory | Amount to be Transferred |
| externalRef | Mandatory | Unique Transaction Id |
| remittanceReason | Mandatory | Reason of the Remittance ( You will get this from Static Data API ) |
| otpReference | Mandatory | Otp Reference Id |
| otp | Mandatory | OTP Received on Remitter Mobile |
| latitude | Mandatory | End User Location |
| longitude | Mandatory | End User Location |
Sample Request
POST /fi/remit/out/nepal/fundTransfer HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825
X-Ipay-Endpoint-Ip: 14.142.186.14
X-Ipay-Request-Hash: 123456789|123456789|123456789|123456789|123456789|123456789|1234
X-Ipay-Request-Timestamp: 1665737179000
X-Ipay-Hash-Check: OFF
User-Agent: InstantPayAPITest/1.0.0
X-Ipay-Outlet-Id: 72762
Content-Type: application/json
Content-Length: 323
{
"externalRef":"098765432112345678900987654",
"remitterMobile":"7428585742",
"beneficiaryId":"1023753",
"transferAmount":"10",
"remittanceReason":"Educational Expenses",
"otpReference":"a228d687-ed51-44b0-af1b-7c5af6137453",
"otp":"172065",
"latitude":"10.0000",
"longitude":"20.0000"
}
curl --location --request POST 'https://api.instantpay.in/fi/remit/out/nepal/fundTransfer' \
--header 'X-Ipay-Auth-Code: 1' \
--header 'X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=' \
--header 'X-Ipay-Client-Secret: 679db35f926b8d0240a8c0d28729528ee8e6d5effa5fa0b20c04454004d2d825' \
--header 'X-Ipay-Endpoint-Ip: 14.142.186.14' \
--header 'X-Ipay-Request-Hash: 123456789|123456789|123456789|123456789|123456789|123456789|1234' \
--header 'X-Ipay-Request-Timestamp: 1665737203000' \
--header 'X-Ipay-Hash-Check: OFF' \
--header 'User-Agent: InstantPayAPITest/1.0.0' \
--header 'X-Ipay-Outlet-Id: 72762' \
--header 'Content-Type: application/json' \
--data-raw '{
"externalRef":"098765432112345678900987654",
"remitterMobile":"7428585742",
"beneficiaryId":"1023753",
"transferAmount":"10",
"remittanceReason":"Educational Expenses",
"otpReference":"a228d687-ed51-44b0-af1b-7c5af6137453",
"otp":"172065",
"latitude":"10.0000",
"longitude":"20.0000"
}'
Response Parameter
| 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:MM:SS) |
| ipay_uuid | String | Request reference number |
| orderid | String | Transaction Id ( If transaction otherwise it is null ) |
| enviroment | String | Live/Sandbox |
| internalCode | String | It will be null |
Sample Response
{
"statuscode": "TXN",
"actcode": null,
"status": "Transaction Successful",
"data": {
"externalRef": "098765432112345678900987654",
"poolReferenceId": "1221012123758FHVCB",
"txnValue": "10.00",
"txnReferenceId": "00",
"pool": {
"account": "7428585742",
"openingBal": "385.18",
"mode": "DR",
"amount": "116.30",
"closingBal": "268.88"
},
"remitterMobile": "7428585742",
"beneficiaryAccount": "",
"beneficiaryBankName": "",
"beneficiaryBranchId": "",
"beneficiaryName": "Beneficiary Name",
"exchangeRate": "1.60",
"payoutAmount": "16.00",
"payoutCurrency": "NPR"
},
"timestamp": "2022-10-12 12:38:03",
"ipay_uuid": "h005977b4e22-6e03-4473-95da-d2d0fe0c04be",
"orderid": "1221012123758FHVCB",
"environment": "LIVE",
"internalCode": null
}
Info :
For API Headers Click Here