Settlements

Learn about settlements.

Availability

This feature is available to eligible Issuing platforms. Contact your Stripe account manager or Stripe Support to confirm request access.

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.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

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

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

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.