AOP Services

Penny Drop Request

POST https://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/Request

This Api submits bank account and beneficiary details to initiate a PennyDrop verification transaction using the specified payment mode.

Body Parameters

{
 "BankName":"Test Bank",
 "IFSCCode":"ABCDXXXXXXXX",                          
 "AccountNumber":"12XXXXXXXXX",                          
 "BenificiaryName":"Test User",                          
 "Address":"Test Address, New Delhi",                          
 "paymentMode":"IMPS",                          
 "RegistrationID":"TEST-XXX-XXX"  
}

Request Parameters

Name	Type	Mandatory	Description
BankName	String	Yes	Bank Name is Required.
IFSCCode	String	Yes	IFSC Code is Required.
AccountNumber	String	Yes	Account Number is Required.
BenificiaryName	String	Yes	Beneficiary Name is Required.
Address	String	Yes	Address is Required.
paymentMode	String	Yes	paymentMode is Required.
RegistrationID	String	Yes	Registration ID provided during partner onboarding.

Responses

200

Response

200

RESPONSE BODY

object

Response

401

RESPONSE BODY

returnMessage string

401

412

Response

412

RESPONSE BODY

returnMessage string

Did this page help you? Yes No

Language

Shell

Python

Node

PHP

cURL

curl --location 'https://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/Request' \
--header 'Content-Type: application/json' \
--data  '{
   "BankName": "Test Bank",
   "IFSCCode": "ABCDXXXXXXXX",
   "AccountNumber": "12XXXXXXXXX",
   "BenificiaryName": "Test User",
   "Address": "Test Address, New Delhi",
   "paymentMode": "IMPS",
   "RegistrationID": "TEST-XXX-XXX"
}'

import requests
import json

url = 'https://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/Request'
payload = json.dumps({
   "BankName": "Test Bank",
   "IFSCCode": "ABCDXXXXXXXX",
   "AccountNumber": "12XXXXXXXXX",
   "BenificiaryName": "Test User",
   "Address": "Test Address, New Delhi",
   "paymentMode": "IMPS",
   "RegistrationID": "TEST-XXX-XXX"
}) 

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://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/Request',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
   "BankName": "Test Bank",
   "IFSCCode": "ABCDXXXXXXXX",
   "AccountNumber": "12XXXXXXXXX",
   "BenificiaryName": "Test User",
   "Address": "Test Address, New Delhi",
   "paymentMode": "IMPS",
   "RegistrationID": "TEST-XXX-XXX"
  }) 
}; 
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://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/Request')
var content = new StringContent(
  "{
   "BankName": "Test Bank",
   "IFSCCode": "ABCDXXXXXXXX",
   "AccountNumber": "12XXXXXXXXX",
   "BenificiaryName": "ABCDE",
   "Address": "Test Address, New Delhi",
   "paymentMode": "IMPS",
   "RegistrationID": "5c702501ba264692baXXXXXXX"
  }",
  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://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/Request',
  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 =>  '{
   "BankName": "Test Bank",
   "IFSCCode": "ABCDXXXXXXXX",
   "AccountNumber": "12XXXXXXXXX",
   "BenificiaryName": "Test User",
   "Address": "Test Address, New Delhi",
   "paymentMode": "IMPS",
   "RegistrationID": "TEST-XXX-XXX"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;

RESPONSE

{
    "code": "200",
    "model": {
      "status": "SUCCESS",
      "clientRefNum": "TEXXXXXXXX",
      "beneficiaryName": "TEST USER",
      "isNameMatch": true,
      "rrn": "12XXXXXXXXX",
      "matchingScore": "XX",
      "paymentMode": "IMPS",
      "transactionId": "TEST-XXXXXXX-XXX"
     }
}

 
{
    "returnMessage": "Unauthorized access. Please log in again."
}

 
{
   "returnMessage": "Invalid registration ID"
}

 
{
   "returnMessage": "Precondition failed. Please try again."
}