Payout

Post  https://payout.oqpay.co.in/api/V7/Payout/IMPS


In this API, you will submit the transfer amount, and beneficiary credentials including name, account number, ifsc code. Along with the user's registration reference, these inputs enable the system to securely initiate a fund transfer through IMPS.

Body Parameters
{
  "accountNumber": "SAMPXXXXXXXX",
  "ifscCode": "SATNXXXXX",
  "amount": 1000,
  "beneficiaryName": "Ajay Singh",
  "registrationID": "OQP-XXXX"
}
Request Parameters
Name Type Description
accountNumber String The account number of the beneficiary."
amount Integer The amount being paid by the customer in this transaction
beneficiaryName String Name of the beneficiary.
registrationID String A unique id often tied to the customer.
ifscCode String IFSC code of the bank.
Responses

200

200

Response

200

RESPONSE BODY

object

statuscode    integer

status    boolean

message    string

uniqueId    string

apiTxnId    string

bank_ref_num    string

externalRef    string

vpa    string

recipient_name    string

amount    integer

charges    integer

tax    integer

adjustment    integer

balance    integer

timestamp    string

environment    string

403

403

Response

403

RESPONSE BODY

Object

status string

subCode string

message string


Did this page help you?     Yes    No

Language
shell Shell
python Python
node Node
c# C#
php PHP

cURL

curl --location 'https://payout.oqpay.co.in/api/V7/Payout/IMPS' \
--header 'Content-Type: application/json' \
--data  '{
    "accountNumber": "SAMPXXXXXXXX",
    "ifscCode": "SATNXXXXX",
    "amount": 1000,
    "beneficiaryName": "Ajay Singh",
    "registrationID": "OQP-XXXX",
}'
                                
import requests
import json

url = 'https://payout.oqpay.co.in/api/V7/Payout/IMPS'
payload = json.dumps({
 "accountNumber": "SAMPXXXXXXXX",
 "ifscCode": "SATNXXXXX",
 "amount": 1000,
 "beneficiaryName": "Ajay Singh",
 "registrationID": "OQP-XXXX",
}) 

headers = {
  "Content-type" : "application/json"
}

response = requests.request("POST", url, headers=headers, data=payload)

print (response.text)
                                
var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://payout.oqpay.co.in/api/V7/Payout/IMPS',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
 "accountNumber": "SAMPXXXXXXXX",
 "ifscCode": "SATNXXXXX",
 "amount": 1000,
 "beneficiaryName": "Ajay Singh",
 "registrationID": "OQP-XXXX",
  }) 
}; 
request(options, function(error, response){
   if(error) throw new Error(error);
   console.log(response.body); 
}); 
                                
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post,'https://payout.oqpay.co.in/api/V7/Payout/IMPS')
var content = new StringContent(
  "{
 "accountNumber": "SAMPXXXXXXXX",
 "ifscCode": "SATNXXXXX",
 "amount": 1000,
 "beneficiaryName": "Ajay Singh",
 "registrationID": "OQP-XXXX",
  }",
  null,"application/json"
); 

request.Content = content;
var response =  await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
                                
<?php
$curl =  curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL =>  'https://payout.oqpay.co.in/api/V7/Payout/IMPS',
  CURLOPT_RETURNTRANSFER =>  true,
  CURLOPT_ENCODING =>  '',
  CURLOPT_MAXREDIRS =>  10,
  CURLOPT_TIMEOUT =>  0,
  CURLOPT_FOLLOWLOCATION =>  true,
  CURLOPT_HTTP_VERSION =>  CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =>  'POST',
  CURLOPT_POSTFIELDS =>  '{
 "accountNumber": "SAMPXXXXXXXX",
 "ifscCode": "SATNXXXXX",
 "amount": 1000,
 "beneficiaryName": "Ajay Singh",
 "registrationID": "OQP-XXXX",
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;
                                

RESPONSE

200

403

409

412

422

-Result

Example


{
  "statuscode": 10000,
  "status": "success",
  "message": "Fund transfer completed successfully.",
  "uniqueId": "3b7b896dfed6418db3a036ea514ba2ea",
  "apiTxnId": "dfweytdfyetdf2132",

  "data": {
    "bank_ref_num": 123456788765,
    "externalRef": "NIFI51929656",
    "vpa": "9555804662@ibl",
    "recipient_name": null
  },

  "deduction": {
    "amount": 100,
    "charges": 13,
    "tax": 1.3,
    "adjustment": 114.3,
    "balance": 893.46
  },

  "timestamp": "2025-05-19T17:10:27+05:30",
  "environment": "production"
}
                                
{
  "status": "ERROR",
  "subCode": "403",
  "message": "APIs not enabled. Please reach out to care@OQP.com"
}
                                
  
{
  "status": "ERROR",
  "subCode": "409",
  "message": "Beneficiary Id already exists"
}
                                
{
  "status": "ERROR",
  "subCode": "412",
  "message": "Post data is empty or not a valid JSON"
}
                                
{
  "status": "ERROR",
  "subCode": "422",
  "message": "Please provide a valid Bank IFSC code."
}