Introduction

API Reference Guide

API Changelog

API Basics

Authentication & Sandbox Setup

Entity & Metadata

Pagination & Rate Limiting

Best Practices

Glossary

Payments

Orders

Payments

Downtime

Settlements

Instant Settlements

Refunds

Disputes

Documents

Customers

Payment Links

QR Codes

Invoices

Items

Plans

Subscriptions

Add-on

Linked Account

Stakeholder

Product Configuration

Transfers

Smart Collect

Smart Collect With TPV

Bills

About Bills

Bills Entity

Create a Bill

Update a Bill

Delete a Bill

Partners

Account

Product Configuration

Stakeholder

Terms and Conditions

Documents

Webhooks

Payout APIs

Get Started

Account Validation

Composite Account Validation

Contacts

Fund Accounts

Payouts

Payouts to Cards

Payout Composite

Payouts Approval

Payout Idempotency

Payout Links

Payout Wallet - Amazon

Transactions

Api

Payments

Downtime

Fetch All

API Test Keys

Fetch All Payment Downtime Details

GET
/v1/payments/downtimes

Click to copy

Use this endpoint to retrieve details of all payment downtimes.

Watch Out!

Payment Downtime APIs are not available in Malaysia.

Is this page helpful?

FPX

Card - Network

Card - Issuer

Card / FPX

Failure

1
{
2
  "entity": "collection",
3
  "count": 2,
4
  "items": [
5
    {
6
      "id": "down_F1cxDoHWD4fkQt",
7
      "entity": "payment.downtime",
8
      "method": "fpx",
9
      "begin": 1591946222,
10
      "end": null,
11
      "status": "started",
12
      "scheduled": false,
13
      "severity": "high",
14
      "instrument": {
15
        "bank": "CIBB"
16
      },
17
      "created_at": 1591946223,
18
      "updated_at": 1591946297
19
    },
20
    {
21
      "id": "down_F1cxlArweEWitF",
22
      "entity": "payment.downtime",
23
      "method": "fpx",
24
      "begin": 1591946222,
25
      "end": null,
26
      "status": "started",
27
      "scheduled": false,
28
      "severity": "high",
29
      "instrument": {
30
        "bank": "PHBM"
31
      },
32
      "created_at": 1591946254,
33
      "updated_at": 1591946298
34
    }
35
  ]
36
}
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 downtime. Possible values include:

  • card
  • fpx

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 Curlec.
  • 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 (3)

created_at
integer

Timestamp (in Unix) that indicates the time at which the downtime was recorded in Curlec servers.

updated_at
integer

Timestamp (in Unix) that indicates the time at which the downtime record was updated in Curlec servers.

card_type
string

The card type used to process the payment. Possible values:

  • credit
  • debit

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 All Payment Downtime Details

GET
/v1/payments/downtimes

Click to copy

Use this endpoint to retrieve details of all payment downtimes.

Watch Out!

Payment Downtime APIs are not available in Malaysia.

Is this page helpful?

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 downtime. Possible values include:

  • card
  • fpx

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 Curlec.
  • 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 (3)

created_at
integer

Timestamp (in Unix) that indicates the time at which the downtime was recorded in Curlec servers.

updated_at
integer

Timestamp (in Unix) that indicates the time at which the downtime record was updated in Curlec servers.

card_type
string

The card type used to process the payment. Possible values:

  • credit
  • debit

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

FPX

Card - Network

Card - Issuer

Card / FPX

Failure

1
{
2
  "entity": "collection",
3
  "count": 2,
4
  "items": [
5
    {
6
      "id": "down_F1cxDoHWD4fkQt",
7
      "entity": "payment.downtime",
8
      "method": "fpx",
9
      "begin": 1591946222,
10
      "end": null,
11
      "status": "started",
12
      "scheduled": false,
13
      "severity": "high",
14
      "instrument": {
15
        "bank": "CIBB"
16
      },
17
      "created_at": 1591946223,
18
      "updated_at": 1591946297
19
    },
20
    {
21
      "id": "down_F1cxlArweEWitF",
22
      "entity": "payment.downtime",
23
      "method": "fpx",
24
      "begin": 1591946222,
25
      "end": null,
26
      "status": "started",
27
      "scheduled": false,
28
      "severity": "high",
29
      "instrument": {
30
        "bank": "PHBM"
31
      },
32
      "created_at": 1591946254,
33
      "updated_at": 1591946298
34
    }
35
  ]
36
}