OQPay Services

Payout

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

In this API, you will submit the transfer amount, and beneficiary credentials including name, UPI ID. Along with the user's registration reference, these inputs enable the system to securely initiate a fund transfer through UPI ensuring proper routing and notification of the transaction.

Body Parameters

{
  "upiID": "ajaysingh99@id.sample",
  "amount": 500,
  "beneficiaryName": "Ajay Singh",
  "registrationID": "OQP-XXXX"
}

Request Parameters

Name	Type	Description
upiID	String	The UPI ID of the person to which amount is being sent."
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.

Table

Name	Type	Description
accountNumber	String	The account number of the user.
amount	String	The amount being paid by the customer in this transaction
transactionType	String	Type of Transaction – IMPS/NEFT for real-time and bundled money transfers, supported 24/7 by banks.
beneficiaryIFSC	String	IFSC code of the beneficiary’s bank branch. Identifies where the money will be sent.
beneficiaryName	String	Name of the bank account holder.
emailID	String	Email address of the user, used for communication, receipts, or verification .
mobileNo	String	Mobile number of the user, often used for verification or notifications
registrationID	String	Unique registration identifier, often tied to the user.

Responses

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

Response

403

RESPONSE BODY

Object

status string

subCode string

message string

Did this page help you? Yes No

Language

Shell

Python

Node

PHP

cURL

curl --location 'https://payout.oqpay.co.in/api/V7/Payout/UPI' \
--header 'Content-Type: application/json' \
--data  '{
    "upiID": "ajaysingh99@upiid.sample",
    "amount": 500,
    "beneficiaryName": "Ajay Singh",
    "registrationID": "OQP-XXXX",
}'

import requests
import json

url = 'https://payout.oqpay.co.in/api/V7/Payout/UPI'
payload = json.dumps({
"upiID": "ajaysingh99@upiid.sample",
"amount": 500,
"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/UPI',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
"upiID": "ajaysingh99@upiid.sample",
"amount": 500,
"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/UPI')
var content = new StringContent(
  "{
 "upiID": "ajaysingh99@upiid.sample",
"amount": 500,
"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/UPI',
  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 =>  '{
"upiID": "ajaysingh99@upiid.sample",
"amount": 500,
"beneficiaryName": "Ajay Singh",
"registrationID": "OQP-XXXX",
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE


{
  "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."
}