Redeem Order Status

Post  https://api.bospay.co.in/api/v1/Aopay/Enach/RedeemOrderStatus


A redemption is created against an existing eNACH subscription.

Body Parameters
{                    
  "registrationID": "AOP-XXX",
  "merchantOrderId": "AOPXXXSUBXXXXXX"                        
}                
Request Parameters
Name Type Description
RegistrationId String Unique registration identifier, often tied to the user.
MerchantOrderId String Unique Merchant Order Id
Request Headers
Key Value
Content-Type application/json
X-API-TOKEN AOP_XXXXXXXXXXXX286XXXXX
X-REGISTRATION-ID AOP-XXX
Responses

200

200

401

401


Did this page help you?     Yes    No

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

cURL

curl --location 'https://api.bospay.co.in/api/v1/Aopay/Enach/RedeemOrderStatus' \
--header 'Content-Type: application/json' \
--header 'X-API-TOKEN: AOP_XXXXXXXXXXXX286XXXXX' \
--header 'X-REGISTRATION-ID: AOP-XXX' \
--data  '{
    "registrationID": "AOP-XXX",
    "merchantOrderId": "AOPXXXSUBXXXXXX"
}'
                                
import requests
import json

url = 'https://api.bospay.co.in/api/v1/Aopay/Enach/RedeemOrderStatus'
payload = json.dumps({
    "registrationID": "AOP-XXX",
    "merchantOrderId": "AOPXXXSUBXXXXXX"
}) 
headers = {
  "Content-type" : "application/json"
  "X-API-TOKEN" : "AOP_XXXXXXXXXXXX286XXXXX",
  "X-REGISTRATION-ID" : "AOP-XXX"
}

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

print (response.text)
                                
var requests = require("request");
var options = { 
  "method" : "POST",
  "url" : 'https://api.bospay.co.in/api/v1/Aopay/Enach/RedeemOrderStatus',
  "headers" : {
    "Content-Type" : 'application/json'
    "X-API-TOKEN" : "AOP_XXXXXXXXXXXX286XXXXX",
    "X-REGISTRATION-ID" : "AOP-XXX"
  },
  body: JSON.stringify({
    "registrationID": "AOP-XXX",
    "merchantOrderId": "AOPXXXSUBXXXXXX"
  }) 
}; 
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://api.bospay.co.in/api/v1/Aopay/Enach/RedeemOrderStatus')

request.Headers.Add("Content-type", "application/json");
request.Headers.Add("X-API-TOKEN", "AOP_XXXXXXXXXXXX286XXXXX");
request.Headers.Add("X-REGISTRATION-ID", "AOP-XXX");

var content = new StringContent(
  "{
    "registrationID": "AOP-XXX",
    "merchantOrderId": "AOPXXXSUBXXXXXX"
  }",
  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://api.bospay.co.in/api/v1/Aopay/Enach/RedeemOrderStatus',
  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 =>  '{
    "registrationID": "AOP-XXX",
    "merchantOrderId": "AOPXXXSUBXXXXXX"
  }',
  CURLOPT_HTTPHEADER =>  array(
    'Content-Type: application/json',
    'X-API-TOKEN: AOP_XXXXXXXXXXXX286XXXXX',
    'X-REGISTRATION-ID: AOP-XXX'
  ),
));
$response =  curl_exec($curl);
curl_close($curl);
echo $response;
                                

RESPONSE

200

401

-Result

Example

{   
    "merchantId": "TXMTXXXX",
    "merchantOrderId": "MO1722319560997",
    "orderId": "OMO2601282154473535900531",
    "state": "COMPLETED",
    "currency": "INR",
    "amount": 200,
    "expireAt": "1769618686824",
    "paymentFlow": {
       "type": "SUBSCRIPTION_REDEMPTION",
       "merchantSubscriptionId": "MS1769569283073",
       "redemptionRetryStrategy": null,
       "autoDebit": false,
       "validAfter": null,
       "validUpto": null,
       "notifiedAt": null
    },
   "paymentDetails": [{
   "transactionId": "OM2601282154486455900694",
   "paymentMode": "ENACH_ACCOUNT",
   "timestamp": 1769617488702,
   "currency": "INR",
   "amount": 200,
   "payableCurrency": "INR",
   "payableAmount": 200,
   "feeCurrency": "INR",
   "feeAmount": 0,
   "state": "COMPLETED",
        "paymentFlow": {
            "type": "ACCOUNT",
            "accountType": "SAVINGS",
            "bankId": "HDFC"
        },
        "rail": {
            "type": "NACH",
            "utr": "ddf5d315-93cd-4019-9137-7bb2ad2ec702"
        },
        "splitInstruments": [{
           "instrument": {
              "type": "ACCOUNT",    
              "accountType": "SAVINGS",    
              "bankId": "HDFC"    
           },
           "rail": {
               "type": "NACH",    
               "utr": "ddf5d315-93cd-4019-9137-7bb2ad2ec702"   
            }, 
           "currency": "INR",                     
           "amount": 200                     
        }]
    }]
}
                                
{
    "Status": false,
    "Message": "Invalid API token or RegistrationID.",
    "ErrorCode": "INVALID_API_TOKEN",
    "StatusCode": 401,
    "RequestId": "55160861-9ccd-482b-85f4-c9521fd4d1ed",
}