Fetch All Payment Downtime Details

Use this endpoint to retrieve details of all payment downtimes.

Response

Netbanking

{
  "entity": "collection",
  "count": 2,
  "items": [
    {
      "id": "down_F1cxDoHWD4fkQt",
      "entity": "payment.downtime",
      "method": "netbanking",
      "begin": 1591946222,
      "end": null,
      "status": "started",
      "scheduled": false,
      "severity": "high",
      "instrument": {
        "bank": "COSB"
      },
      "created_at": 1591946223,
      "updated_at": 1591946297
    },
    {
      "id": "down_F1cxlArweEWitF",
      "entity": "payment.downtime",
      "method": "netbanking",
      "begin": 1591946222,
      "end": null,
      "status": "started",
      "scheduled": false,
      "severity": "high",
      "instrument": {
        "bank": "UTIB"
      },
      "created_at": 1591946254,
      "updated_at": 1591946298
    }
  ]
}
```json: UPI Handle
{
    "entity": "collection",
    "count": 1,
    "items": [
      {
        "id": "down_F8LCfthx90fMOo",
        "entity": "payment.downtime",
        "method": "upi",
        "begin": 1593412063,
        "end": null,
        "status": "started",
        "scheduled": false,
        "severity": "high",
        "instrument": {
          "vpa_handle": "oksbi"
        },
        "created_at": 1593412092,
        "updated_at": 1593412092
      }
    ]
}
```json: UPI PSP
{
    "entity": "collection",
    "count": 1,
    "items": [
      {
        "id": "down_F8LCfthx90fMOo",
        "entity": "payment.downtime",
        "method": "upi",
        "begin": 1593412063,
        "end": null,
        "status": "started",
        "scheduled": false,
        "severity": "high",
        "instrument": {
          "psp": "bhim",
          "flow": "collect"
        },
        "created_at": 1593412092,
        "updated_at": 1593412092
      }
    ]
}
```json: Turbo UPI
{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "down_F1cxDoHWD4fkQt",
      "entity": "payment.downtime",
      "method": "upi",
      "begin": 1591946222,
      "end": null,
      "status": "started",
      "scheduled": false,
      "severity": "high",
      "instrument": {
        "flow": "in_app"
      },
      "created_at": 1591946223,
      "updated_at": 1591946297
    }
  ]
}
```json: Card - Network
{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "down_F7LroRQAAFuswd",
      "entity": "payment.downtime",
      "method": "card",
      "begin": 1593196031,
      "end": null,
      "status": "started",
      "scheduled": false,
      "severity": "high",
      "instrument": {
        "network": "VISA"
      },
      "created_at": 1593196089,
      "updated_at": 1593196089
    }
  ]
}
```json: Card - Issuer
{
  "entity": "collection",
  "count": 1,
  "items": [
    {
      "id": "down_F7LroRQAAFuswd",
      "entity": "payment.downtime",
      "method": "card",
      "begin": 1593196031,
      "end": null,
      "status": "started",
      "scheduled": false,
      "severity": "high",
      "instrument": {
        "issuer": "SBIN"
      },
      "created_at": 1593196089,
      "updated_at": 1593196089
    }
  ]
}
```json: Card / Netbanking
{
    "entity": "collection",
    "count": 2,
    "items": [
      {
        "id": "down_F7LroRQAAFuswd",
        "entity": "payment.downtime",
        "method": "card",
        "begin": 1593196031,
        "end": null,
        "status": "started",
        "scheduled": false,
        "severity": "high",
        "instrument": {
          "issuer": "SBIN",
          "card_type": "credit"
        },
        "created_at": 1593196089,
        "updated_at": 1593196089
      },
      {
      "id": "down_F1cxDoHWD4fkQt",
      "entity": "payment.downtime",
      "method": "netbanking",
      "begin": 1591946222,
      "end": null,
      "status": "started",
      "scheduled": false,
      "severity": "high",
      "instrument": {
        "bank": "COSB"
      },
      "created_at": 1591946223,
      "updated_at": 1591946297
    },
    ]
}

```json: Failure
{
    "error": {
        "code": "BAD_REQUEST_ERROR",
        "description": "The api key provided is invalid",
        "source": "NA",
        "step": "NA",
        "reason": "NA",
        "metadata": {}
    }
}

Parameters

id : string Unique identifier of the downtime’s occurrence. entity : string Here, it will be payment.downtime. method : string The payment method that is experiencing the downtime. Possible values include:

card
netbanking
upi

begin : integer Timestamp (in Unix) that indicates the start of the downtime. Applicable for both scheduled and unscheduled downtimes. end : integer Timestamp (in Unix) that indicates the end of the downtime. Available only for scheduled downtimes, where the end-time is known. Set to null when the end-time is unknown, possibly during unscheduled downtimes. status : string Status of the downtime. Possible statuses are.

scheduled: A downtime is scheduled to happen at a later time.
started: The downtime has started and is ongoing.
updated: An ongoing downtime that has been updated after its start. For example, when the severity of the downtime changes from medium to high.

scheduled : boolean Possible values:

true: This is a scheduled downtime by the issuer, network, or the bank, which was informed to Razorpay.
false: This is an unscheduled downtime.

severity : string Severity of the downtime. Possible values:

high: Possible when all the payment methods are affected by downtime. Observed when the issuer, bank or network is down.
medium: Possible when a higher number of declines in transactions or low success rates are observed with the payment methods.
low: Possible when the reason for the downtime is unknown. Impact on payment methods is minimal.

instrument : string Payment method that is underperforming. bank if method=netbanking : string Bank code of the affected bank. Possible values:

HDFC
ICIC
SBIN
KKBK
UTIB
PUNB

network if method=card : string Card network. Possible values:

AMEX
DICL
MC
RUPAY
VISA
ALL

issuer if method=card : string The 4-character issuer code unique to each issuing bank in India. Possible values:

SBIN
HDFC
ICIC
UTIB
CITI
PUNB
KKBK
CNRB
BKID
BARB
JAKA
UBIN

psp if method=upi : string Code of the affected Payment Service Provider (PSP). This is populated only when VPA handles associated with the PSP are down. If a PSP is associated with multiple VPA handles, it is marked down only when all the handles associated with it are down. For example, google_pay is marked down only when all Google Pay handles - oksbi, okhdfcbank, okicici and okaxis are down. Possible values for this parameter are:

google_pay
phonepe
paytm
bhim

vpa_handle if method=upi : string Affected VPA handle. For example, @oksbi. To learn about the possible values, refer to the list of handles supported by NPCI. If the entire UPI system is experiencing a downtime, the value ALL is displayed. card_type if method=card : string The card type used to process the payment. Possible values:

credit
debit

flow : string Indicates the UPI payments flow being used during the downtime event. Possible values:

collect
intent
in_app Only applicable for Turbo UPI payments.

created_at : integer Timestamp (in Unix) that indicates the time at which the downtime was recorded in Razorpay servers. updated_at : integer Timestamp (in Unix) that indicates the time at which the downtime record was updated in Razorpay servers. Know more about the possible values.

Errors

The API {key/secret} provided is invalid.

code: 4xx
description: The API credentials passed in the API call differ from the ones generated on the Dashboard.
solution: The API keys must be active and entered correctly with no whitespace before or after.

Introduction

API Guides

Core Resources API

Products API

Additional Resources

Payments

QR Codes

RazorpayX

Partners

Fetch All Payment Downtime Details

Response

Parameters

Errors

​Response

​Parameters

​Errors

Response

Parameters

Errors