Penny Drop Status

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


Check the current status of an existing Penny Drop transaction.

Body Parameters
{
 "RefID":"TEXXXXXXXXX",  
 "RegistrationID":"TEST-XXXX-XXX"  
}
Request Parameters
Name Type Mandatory Description
RefID String Yes RefID is Required
RegistrationID String Yes Registration ID provided during partner onboarding.
Responses

200

200

Response

200

RESPONSE BODY

object

Response

401

RESPONSE BODY

returnMessage     string

401

401

412

412

Response

412

RESPONSE BODY

returnMessage     string


Did this page help you?     Yes    No

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

cURL

curl --location 'https://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/CheckStatus' \
--header 'Content-Type: application/json' \
--data  '{
   "RefID": "TEXXXXXXXXX",
   "RegistrationID": "TEST-XXXX-XXX"
}'
                                
import requests
import json

url = 'https://XXXXXXXXXXXXXXXX/api/AOP/V1/PennyDrop/CheckStatus'
payload = json.dumps({
    "RefID": "TEXXXXXXXXX",
    "RegistrationID": "TEST-XXXX-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/CheckStatus',
  "headers" : {
    "Content-Type" : 'application/json'
  },
  body: JSON.stringify({
    "RefID": "TEXXXXXXXXX",
    "RegistrationID": "TEST-XXXX-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/CheckStatus')
var content = new StringContent(
  "{
    "RefID": "TEXXXXXXXXX",
    "RegistrationID": "TEST-XXXX-XXX"
  }",
  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/CheckStatus',
  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 =>  '{
    "RefID": "TEXXXXXXXXX",
    "RegistrationID": "TEST-XXXX-XXX"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;
                                

RESPONSE

200

401

412

-Result

Example

{
    "code": "200",
    "model": {
    "status": "SUCCESS",
    "clientRefNum": "TEXXXXXXXX",
    "beneficiaryName": "ABCDE",
    "isNameMatch": true,
    "rrn": "12XXXXXXXXX",
    "matchingScore": "XX",
    "paymentMode": "IMPS",
    "transactionId": "5c702501ba264692baXXXXXXX"
    }    
}


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

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