# Settlements

Learn about settlements.

> #### Availability
> 
> This feature is available to eligible Issuing platforms. Contact your Stripe account manager or [Stripe Support](https://support.stripe.com/) to confirm request access.

We reconcile transactions and settle funds for you on your behalf unless the network requires you to settle with them directly (for example, if you use your own BIN).

As a card issuer, you’re obligated to periodically settle funds with each card network. The card network moves funds to and from the issuer each business day to cover all of the transactions that have been made by cardholders and have been cleared since the last settlement cycle.

Because you’re required to settle funds with the network directly, we provide you with the following required information:

- The settlement reports detailing the amount owed
- The transactions that contribute to the settlement
- The disputes that contribute to the settlement
- The fees that contribute to the settlement

## Settlement lifecycle 

Stripe makes available daily settlement reports represented by a [Settlement](https://docs.stripe.com/api.md#issuing_settlement_object) object. These reports include the transaction volume, reimbursed interchange, network fees, and net amount required to settle with the network.

The following settlement report demonstrates the clearing and settlement lifecycle:

```json
{
  "id": "ise_1DpUzaDPRbc1ws4rKrJpCSXQ",
  "object": "issuing.settlement",
  "bin": "405551",
  "created": 1546755614,
  "currency": "usd",
  "interchange_fees_amount": 178832,
  "livemode": false,
  "metadata": {
  },
  "net_total_amount": -6776886,
  "network": "visa",
  "network_fees_amount": -3024,
  "network_settlement_identifier": "1000633976",
  "other_fees_amount": 0,
  "other_fees_count": 0,
  "settlement_date": 1546755614,
  "settlement_service": "international",
  "status": "pending",
  "transaction_count": 879,
  "transaction_amount": -6952694
}
```

When we receive the daily clearing file from the card network, we create the settlement report and reconcile all of the transactions in the file against the transactions on your account for that time period. We then attach the ID of the settlement to each transaction. Finally, when all transactions have been reconciled, we update the `transactions_reconciled` flag on the settlement to `true`.

Stripe notifies you of these changes with webhook events:

- We send the `issuing_settlement.created` event when Stripe receives a settlement report from the network and we create the Settlement object with `status` set to `pending`.
- The transactions associated with the settlement are updated with the settlement ID, which triggers the `issuing_transaction.updated` event.
- We send the `issuing_settlement.updated` event when the settlement `status` switches from `pending` to `complete`.

You can also view settlements in the Dashboard under the **Settlements** tab. The Dashboard shows a list of your settlements, the details of each settlement, and the events and transactions involved in each settlement.

Here’s an example of how the daily Settlement Summary Report (VSS-110) we receive from Visa translates into the different fields in a Settlement object.

| currency code | amount type | business mode | count | net amount monetary |
| --- | --- | --- | --- | --- |
| usd | interchange | acquirer | 0 | 0.00 usd |
| usd | interchange | issuer | 11153 | -3,476,495.77 usd |
| usd | interchange | other | 0 [other_fees_count](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-other_fees_count) | 0.00 usd [other_fees_amount](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-other_fees_amount) |
| usd | interchange | total | 11153 [transaction_count](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-transaction_count) | -3,476,495.77 usd [transaction_amount](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-transaction_amount) |
| usd | reimbursement_fees | acquirer |  | 0.00 usd |
| usd | reimbursement_fees | issuer |  | 80,811.05 usd |
| usd | reimbursement_fees | other |  | 0.00 usd |
| usd | reimbursement_fees | total |  | 80,811.05 usd [interchange_fees_amount](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-interchange_fees_amount) |
| usd | visa_charges | acquirer |  | 0.00 usd |
| usd | visa_charges | issuer |  | -1,076.06 usd |
| usd | visa_charges | other |  | 0.00 usd |
| usd | visa_charges | total |  | -1,076.06 usd [network_fees_amount](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-network_fees_amount) |
| usd | total | acquirer |  | 0.00 usd |
| usd | total | issuer |  | -3,396,760.78 usd |
| usd | total | other |  | 0.00 usd |
| usd | total | total |  | -3,396,760.78 usd [net_total_amount](https://docs.stripe.com/api/issuing/settlements/object.md#issuing_settlement_object-net_total_amount) |

The following is the settlement object with status `complete` that was created for the VSS-110 report shown above.

```json
{
  "id": "ise_1R9Op42j5ohbiDWAVaavpeVG",
  "object": "issuing.settlement",
  "bin": "405551",
  "created": 1743590826,
  "currency": "usd",
  "interchange_fees_amount": 8081105,
  "livemode": false,
  "metadata": {
  },
  "net_total_amount": -339676078,
  "network": "visa",
  "network_fees_amount": -107606,
  "network_settlement_identifier": "1000633976",
  "other_fees_amount": 0,
  "other_fees_count": 0,
  "settlement_date": 1743552000,
  "settlement_service": "international",
  "status": "complete",
  "transaction_count": 11153,
  "transaction_amount": -347649577
}
```

To determine the transactions that comprise the settlement, you can list the transactions associated with the settlement by querying the [list API associated with the Transactions](https://docs.stripe.com/api/issuing/transactions/list.md) object.

```curl
curl -G https://api.stripe.com/v1/issuing/transactions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d settlement=ise_1R9Op42j5ohbiDWAVaavpeVG
```

```json
{
  "object": "list",
  "url": "/v1/issuing/transactions",
  "has_more": false,
  "data": [
    {
      "id": "ipi_1MzFN1K8F4fqH0lBmFq8CjbU",
      "object": "issuing.transaction",
      "amount": -347647577,
      "authorization": "iauth_1MzFMzK8F4fqH0lBc9VdaZUp",
      "balance_transaction": "txn_1MzFN1K8F4fqH0lBQPtqUmJN",
      "card": "{{CARD_ID}}",
      "cardholder": "{{CARDHOLDER_ID}}",
      "created": 1743542000,
      "currency": "usd",
      "livemode": true,
      "merchant_data": {...},
      "type": "capture",
      "settlement": "ise_1R9Op42j5ohbiDWAVaavpeVG",
      ...
    },
    {
      "id": "ipi_1MzFN1K8F4fqH0lBmFq9DkYT",
      "object": "issuing.transaction",
      "amount": -1000,
      "authorization": "iauth_1MzFMzK8F4fqH0lBc9VdaTvR",
      "balance_transaction": "txn_1MzFN1K8F4fqH0lBQPtqUlKU",
      "card": "{{CARD_ID}}",
      "cardholder": "{{CARDHOLDER_ID}}",
      "created": 1743542500,
      "currency": "usd",
      "livemode": true,
      "merchant_data": {...},
      "type": "capture",
      "settlement": "ise_1R9Op42j5ohbiDWAVaavpeVG",
      ...
    }
  ],
}
```

You can also query the dispute settlement details for the given settlement using the [list API associated with the Dispute Settlement Details](https://docs.stripe.com/api/issuing/dispute-settlement-detail/list.md) object.

```curl
curl -G https://api.stripe.com/v1/issuing/dispute_settlement_details \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d settlement=ise_1R9Op42j5ohbiDWAVaavpeVG
```

```json
{
  "object": "list",
  "url": "/v1/issuing/dispute_settlement_details",
  "has_more": false,
  "data": [
    {
      "id": "idsd_1MzFN1K8M4JkH0lBmFq8CqBS",
      "object": "issuing.dispute_financial",
      "amount": 1000,
      "card": "{{CARD_ID}}",
      "cardholder": "{{CARDHOLDER_ID}}",
      "created": 1743532000,
      "currency": "usd",
      "livemode": true,
      "merchant_data": {...},
      "event_type": "arbitration",
      "settlement": "ise_1R9Op42j5ohbiDWAVaavpeVG",
      ...
    }
  ],
}
```

The sum of the `amount` fields associated with the transactions and the `amount` field associated with the dispute settlement details is equal to the `transaction_amount` field associated with the settlement object.

The `net_total_amount` on the Settlement object is equal to the sum of `transaction_amount`, `other_fees_amount`, `interchange_fees_amount` and the `network_fees_amount` fields on the Settlement object.
