Settlements

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 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:

{
  "id": "ise_1DpUzaDPRbc1ws4rKrJpCSXQ",
  "object": "issuing.settlement",
  "bin": "405551",
  "created": 1546755614,
  "currency": "usd",
  "interchange_fees_amount": 178832,
  "livemode": false,
  "metadata": {
  },

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.

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

{
  "id": "ise_1R9Op42j5ohbiDWAVaavpeVG",
  "object": "issuing.settlement",
  "bin": "405551",
  "created": 1743590826,
  "currency": "usd",
  "interchange_fees_amount": 8081105,
  "livemode": false,
  "metadata": {
  },

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 object.

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

{
  "object": "list",
  "url": "/v1/issuing/transactions",
  "has_more": false,
  "data": [
    {
      "id": "ipi_1MzFN1K8F4fqH0lBmFq8CjbU",
      "object": "issuing.transaction",
      "amount": -347647577,
      "authorization": "iauth_1MzFMzK8F4fqH0lBc9VdaZUp",

You can also query the dispute settlement details for the given settlement using the list API associated with the Dispute Settlement Details object.

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

{
  "object": "list",
  "url": "/v1/issuing/dispute_settlement_details",
  "has_more": false,
  "data": [
    {
      "id": "idsd_1MzFN1K8M4JkH0lBmFq8CqBS",
      "object": "issuing.dispute_financial",
      "amount": 1000,
      "card": 
"{{CARD_ID}}",

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.