GET
/
disputes
/
{dispute_id}

Authorizations

api-key
string
header
required

Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.

Path Parameters

dispute_id
string
required

The identifier for dispute

Response

200 - application/json
amount
string
required

The dispute amount

attempt_id
string
required

The identifier for payment_attempt

connector
string
required

connector to which dispute is associated with

connector_dispute_id
string
required

Dispute id sent by connector

connector_status
string
required

Status of the dispute sent by connector

created_at
string
required

Time at which dispute is received

currency
enum<string>
required

The three letter ISO currency code in uppercase. Eg: 'USD' for the United States Dollar.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLE,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XCD,
XOF,
XPF,
YER,
ZAR,
ZMW,
ZWL
dispute_id
string
required

The identifier for dispute

dispute_stage
enum<string>
required

Stage of the dispute

Available options:
pre_dispute,
dispute,
pre_arbitration
dispute_status
enum<string>
required

Status of the dispute

Available options:
dispute_opened,
dispute_expired,
dispute_accepted,
dispute_cancelled,
dispute_challenged,
dispute_won,
dispute_lost
payment_id
string
required

The identifier for payment_intent

challenge_required_by
string | null

Evidence deadline of dispute sent by connector

connector_created_at
string | null

Dispute created time sent by connector

connector_reason
string | null

Reason of dispute sent by connector

connector_reason_code
string | null

Reason code of dispute sent by connector

connector_updated_at
string | null

Dispute updated time sent by connector

merchant_connector_id
string | null

The merchant_connector_id of the connector / processor through which the dispute was processed

profile_id
string | null

The profile_id associated with the dispute