API Test Keys

Fetch Payment Downtime Details With ID

GET
/v1/payments/downtimes/:id

Click to copy

Use this endpoint to fetch downtime status if you have not received any webhook notifications due to technical issues. Usually, downtime webhook payloads are delivered within few seconds of the event. However, in some cases, this can be delayed by few minutes due to various reasons.

Is this page helpful?

Curl

change language

change language

1
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
2
-X GET https://api.razorpay.com/v1/payments/downtimes/down_F1cxDoHWD4fkQt
3
-H "Content-Type: application/json" \

Netbanking

UPI Handle

UPI PSP

Turbo UPI

Card - Issuer

Card - Network

1
{
2
"id": "down_F1cxDoHWD4fkQt",
3
"method": "netbanking",
4
"begin": 1591946222,
5
"end": null,
6
"status": "started",
7
"scheduled": false,
8
"severity": "high",
9
"instrument": {
10
"bank": "COSB"
11
},
12
"created_at": 1591946223,
13
"updated_at": 1591946297
14
}
Path Parameters
id

*

string

Unique identifier of the payment.

Response 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.
  • resolved: The downtime is resolved.
  • cancelled: A scheduled downtime that is invalidated. For example, when a scheduled downtime was communicated but was later cancelled by the bank.

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.

Show child parameters (6)

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.

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.
    Know more about .

Errors

The API {key/secret} provided is invalid.

Error Status: 4xx

The API credentials passed in the API call differ from the ones generated on the Dashboard.

Solution

Fetch Payment Downtime Details With ID

GET
/v1/payments/downtimes/:id

Click to copy

Use this endpoint to fetch downtime status if you have not received any webhook notifications due to technical issues. Usually, downtime webhook payloads are delivered within few seconds of the event. However, in some cases, this can be delayed by few minutes due to various reasons.

Is this page helpful?

Path Parameters
id

*

string

Unique identifier of the payment.

Response 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.
  • resolved: The downtime is resolved.
  • cancelled: A scheduled downtime that is invalidated. For example, when a scheduled downtime was communicated but was later cancelled by the bank.

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.

Show child parameters (6)

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.

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.
    Know more about .

Errors

The API {key/secret} provided is invalid.

Error Status: 4xx

The API credentials passed in the API call differ from the ones generated on the Dashboard.

Solution

Curl

change language

change language

1
curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
2
-X GET https://api.razorpay.com/v1/payments/downtimes/down_F1cxDoHWD4fkQt
3
-H "Content-Type: application/json" \

Netbanking

UPI Handle

UPI PSP

Turbo UPI

Card - Issuer

Card - Network

1
{
2
"id": "down_F1cxDoHWD4fkQt",
3
"method": "netbanking",
4
"begin": 1591946222,
5
"end": null,
6
"status": "started",
7
"scheduled": false,
8
"severity": "high",
9
"instrument": {
10
"bank": "COSB"
11
},
12
"created_at": 1591946223,
13
"updated_at": 1591946297
14
}