# issuing.dispute

From **Stripe API**.

As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.

Related guide: [Disputing Transactions](https://stripe.com/docs/issuing/purchases/disputes)

- Type: `object`

## Properties

### `amount`

- Required: true
- Type: `integer`

Disputed amount. Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).

### `balance_transactions`

- Required: false
- Type: `array`
- Nullable: true

List of balance transactions associated with the dispute.

### `created`

- Required: true
- Type: `integer`
- Format: `unix-time`

Time at which the object was created. Measured in seconds since the Unix epoch.

### `currency`

- Required: true
- Type: `string`

The currency the `transaction` was made in.

### `evidence`

- Required: true
- Type: `object`

### `id`

- Required: true
- Type: `string`
- maxLength: `5000`

Unique identifier for the object.

### `livemode`

- Required: true
- Type: `boolean`

Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

### `metadata`

- Required: true
- Type: `object`

Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

### `object`

- Required: true
- Type: `string`
- Allowed values: `"issuing.dispute"`

String representing the object's type. Objects of the same type share the same value.

### `status`

- Required: true
- Type: `string`
- Allowed values: `"expired"`, `"lost"`, `"submitted"`, `"unsubmitted"`, `"won"`

Current status of the dispute.

### `transaction`

- Required: true
The transaction being disputed.

## JSON Schema

```json
{"description":"As a [card issuer](https://stripe.com/docs/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.\n\nRelated guide: [Disputing Transactions](https://stripe.com/docs/issuing/purchases/disputes)","properties":{"amount":{"description":"Disputed amount. Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).","type":"integer"},"balance_transactions":{"description":"List of balance transactions associated with the dispute.","items":{"$ref":"#/components/schemas/balance_transaction"},"nullable":true,"type":"array"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"The currency the `transaction` was made in.","type":"string"},"evidence":{"$ref":"#/components/schemas/issuing_dispute_evidence"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["issuing.dispute"],"type":"string"},"status":{"description":"Current status of the dispute.","enum":["expired","lost","submitted","unsubmitted","won"],"type":"string"},"transaction":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/issuing.transaction"}],"description":"The transaction being disputed.","x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/issuing.transaction"}]}}},"required":["amount","created","currency","evidence","id","livemode","metadata","object","status","transaction"],"title":"IssuingDispute","type":"object","x-expandableFields":["balance_transactions","evidence","transaction"],"x-resourceId":"issuing.dispute"}
```