# issuing.settlement

From **Stripe API**.

When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object.

- Type: `object`

## Properties

### `bin`

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

The Bank Identification Number reflecting this settlement record.

### `clearing_date`

- Required: true
- Type: `integer`

The date that the transactions are cleared and posted to user's accounts.

### `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`

Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).

### `id`

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

Unique identifier for the object.

### `interchange_fees`

- Required: true
- Type: `integer`

The total interchange received as reimbursement for the transactions.

### `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.

### `net_total`

- Required: true
- Type: `integer`

The total net amount required to settle with the network.

### `network`

- Required: true
- Type: `string`
- Allowed values: `"visa"`

The card network for this settlement report. One of ["visa"]

### `network_fees`

- Required: true
- Type: `integer`

The total amount of fees owed to the network.

### `network_settlement_identifier`

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

The Settlement Identification Number assigned by the network.

### `object`

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

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

### `settlement_service`

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

One of `international` or `uk_national_net`.

### `transaction_count`

- Required: true
- Type: `integer`

The total number of transactions reflected in this settlement.

### `transaction_volume`

- Required: true
- Type: `integer`

The total transaction amount reflected in this settlement.

## JSON Schema

```json
{"description":"When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object.","properties":{"bin":{"description":"The Bank Identification Number reflecting this settlement record.","maxLength":5000,"type":"string"},"clearing_date":{"description":"The date that the transactions are cleared and posted to user's accounts.","type":"integer"},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).","type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"interchange_fees":{"description":"The total interchange received as reimbursement for the transactions.","type":"integer"},"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"},"net_total":{"description":"The total net amount required to settle with the network.","type":"integer"},"network":{"description":"The card network for this settlement report. One of [\"visa\"]","enum":["visa"],"type":"string"},"network_fees":{"description":"The total amount of fees owed to the network.","type":"integer"},"network_settlement_identifier":{"description":"The Settlement Identification Number assigned by the network.","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["issuing.settlement"],"type":"string"},"settlement_service":{"description":"One of `international` or `uk_national_net`.","maxLength":5000,"type":"string"},"transaction_count":{"description":"The total number of transactions reflected in this settlement.","type":"integer"},"transaction_volume":{"description":"The total transaction amount reflected in this settlement.","type":"integer"}},"required":["bin","clearing_date","created","currency","id","interchange_fees","livemode","metadata","net_total","network","network_fees","network_settlement_identifier","object","settlement_service","transaction_count","transaction_volume"],"title":"IssuingSettlement","type":"object","x-expandableFields":[],"x-resourceId":"issuing.settlement"}
```