1. Home
  2. Docs
  3. Developers Guide
  4. Integration APIs
  5. Downtime Check APIs

Downtime Check APIs

There are 3 APIs that help us to get the downtime of the Net banking or card bins for all banks which are observing either full downtime or partial downtime

  • getNetbankingStatus : This API is used to help you in handling the NetBanking Downtime. A few times, one or more Net Banking options may be facing downtime due to issues observed at Bank’s end. This API is used to tell the status of one or all the net banking options. The status can be either up or down. If you want to know the status of a specific Net Banking option, the input parameter should contain the corresponding ibibo_code. If you want to know the status of all the Net Banking options, the input parameter should contain the value ‘default’.
  • This API is used to help you in handling the Credit Card/Debit Card Issuing Bank Downtime. It allows you get the present status of an Issuing Bank using the specific Bank Identification Number (BIN). BIN is identified as the first 6 digits of a credit/debit card. You need to provide the bin number as input and the corresponding issuing bank’s status would be returned in the output (whether up or down).
  • This command is used to retrieve the card bins for all banks which are observing either full downtime or partial downtime at an instant. The information related to full/partial downtime depends on the input parameter values

getNetbankingStatus

This API helps you in handling the NetBanking Downtime.

API EndPoint : POST https://test.payu.in/merchant/postservice?form=2

Request Parameters

ParameterDescriptionValue
keyMerchant key provided by PayU. Please refer to the first entry in the Post Parameters table for detailed description of this parameter JPTXg
command This parameter must have name of the web-service. getNetbankingStatus
var1 ibibo_code or “default” AXIB/“default”
hashThis parameter must contain the hash value to be calculated at your end. The string used for calculating the hash is mentioned below:
sha512(key|command|var1|salt)
sha512 is the encryption method used here
c24ee06c7cf40314ede424
b1fcc2b97a12f97a7d3dd2
06876eef16660eb09fd374
fd82861f66d8152e72d1c9
e3ee37fc691d47d6a38750
2872b03c7338a50880

Request Body

curl -X POST "https://test.payu.in/merchant/postservice?form=2
-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d

"key=JP***g&command=getNetbankingStatus&var1=AXIB&hash=11f17a5b7b3a93bd0391a0447706ebebd37ab11d8ec8aff18e7d0ca6267f44d6b0b56c4bee6a8b8998acec1491be17047d43ad3ef1b4677bf2504f48d3e779ea"

Response Body

a. If successfully fetched

{
      "ibibo_code": "AXIB",
      "title": "AXIS Bank NetBanking",
      "up_status": 0,
      "mode": "NB"
}

b. To get status of all Net Banking options pass (value “default” is passed in input)

{
      "AXIB": {
            "ibibo_code": "AXIB",
            "title": "AXIS Bank NetBanking",
            "up_status": 0,
            "mode": "NB"
      },
      "SBIB": {
            "ibibo_code": "SBIB",
            "title": "State Bank of India",
            "up_status": 1,
            "mode": "NB"
      },
      "TESTPGNB": {
            "ibibo_code": "TESTPGNB",
            "title": "Test Net Banking",
            "up_status": 1,
            "mode": "NB"
      },
      "UPI": {
            "ibibo_code": "UPI",
            "title": "Test UPI",
            "up_status": 1,
            "mode": "UPI"
      },
      "CASH": {
            "ibibo_code": "CASH",
            "title": "Test Wallet",
            "up_status": 1,
            "mode": "CASH"
      }
}
  • up_status = 0 signifies that the particular Bank option is down at the moment.
  •  up_status=1 signifies that the particular Bank Banking option is up at the moment.

getIssuingBankStatus

This API is used to help you in handling the Credit Card/Debit Card Issuing Bank Downtime. 

API EndPoint : POST https://test.payu.in/merchant/postservice?form=2

Request Parameters

ParameterDescriptionValue
keyMerchant key provided by PayU. Please refer to the first entry in the Post Parameters table for detailed description of this parameter JPTXg
command This parameter must have name of the web-service. getIssuingBankStatus
var1 Bank Identification Number
(First 6 digits of a card)
512345
hashThis parameter must contain the hash value to be calculated at your end. The string used for calculating the hash is mentioned below:
sha512(key|command|var1|salt)
sha512 is the encryption method used here
c24ee06c7cf40314ede424
b1fcc2b97a12f97a7d3dd2
06876eef16660eb09fd374
fd82861f66d8152e72d1c9
e3ee37fc691d47d6a38750
2872b03c7338a50880

Request Body

curl -X POST "https://test.payu.in/merchant/postservice?form=2
-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d

"key=JP***g&command=getIssuingBankStatus&var1=512345&hash=190908741314524c922d9587298eb64a076d058c085c66229f5acfeac4fb8a11dcd41f3f566cdb2e14a12f486a598a4e56943a2390c258384add9aeed1885e9d"

Response Body

a. If successfully fetched

{
      "issuing_bank": "HDFC",
      "up_status": "1"
}
  • up_status = 0 signifies that the particular Bank option is down at the moment.
  • up_status= 1 signifies that the particular Bank Banking option is up at the moment.

getIssuingBankDownBins

This command is used to retrieve the card bins for all banks which are observing either full downtime or partial downtime at an instant

API Endpoint : POST https://test.payu.in/merchant/postservice?form=2

Request Parameters

ParameterDescriptionValue
keyMerchant key provided by PayU. Please refer to the first entry in the Post Parameters table for detailed description of this parameter JPTXg
command This parameter must have name of the web-service. getIssuingBankDownBins
var1 Bank Name code (To be Provided by PayU) or “default” Default

var2 
1 if you want to extract information about partially down bins as well and 0 if you want information about fully down bins only. 0/1
hashThis parameter must contain the hash value to be calculated at your end. The string used for calculating the hash is mentioned below:
sha512(key|command|var1|salt)
sha512 is the encryption method used here
c24ee06c7cf40314ede424
b1fcc2b97a12f97a7d3dd2
06876eef16660eb09fd374
fd82861f66d8152e72d1c9
e3ee37fc691d47d6a38750
2872b03c7338a50880

Request Body

curl -X POST "https://test.payu.in/merchant/postservice?form=2
-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d

"key=JP***g&command=getIssuingBankDownBins&var1=ALLBD&var2=1&hash=efc4452469091d4d6061fcf6bce45c8116675972a89ddcba6bdd27dce613ca6e48e703e3ba7f6015ef128eda60ed61a3307795c5dd7e284a7691f0c6dc3812a8"

Response Body

a. If successfully fetched:

[
      {
            "issuing_bank": "ALLBD",
            "status": 2,
            "title": "ALLAHABAD BANK",
            "bins_arr": [
                  "421337",
                  "608219",
                  "608218",
                  "608171",
                  "608102",
                  "607352",
                  "607137",
                  "607038",
                  "607091",
                  "607016",
                  "607117",
                  "430450",
                  "652204"
            ]
      }
]

Request Parameters

ParameterDescriptionValue
issuing_bankThe bank which is down or partially downALLBD
status 0 if the issuing bank is completely down and 2 if it is0/2
title title of the bank ALLAHABAD BANK

bins_arr
The card bins array[
“421337”,
“608219”,
“608218”,
“608171”
]