---
updatedAt: 2025-11-13T14:09:31.000Z
agentTools:
  siteIndex: https://docs.affirm.com/llms.txt
  projectIndex: https://docs.affirm.com/developers/llms.txt
---

# Transaction States

When you use the Transactions API, transactions move through a series of different states, such as authorized or captured. Learn more about Affirm's transaction states.

<HTMLBlock>{`
<style>
  .dropdown-menu {
    font-family: Arial, sans-serif;
    max-width: 250px;
    margin-left: auto; /* Align to the right */
  	margin-right: 0; /* Ensure it's flush to the right */
    border: 1px solid #ddd;
    border-radius: 8px;
    padding: 10px;
    background: #4A4AF4;
    overflow: hidden; /* Ensure the container grows with content */
  }

  .dropdown-item {
    margin-bottom: 10px;
  }

  .dropdown-toggle {
    display: block;
    width: 100%;
    text-align: left;
    padding: 10px;
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 4px;
    cursor: pointer;
  }

  .dropdown-toggle:hover {
    background: #f0f0f0;
  }

  .dropdown-content {
    display: none;
    margin-top: 5px;
    padding: 10px;
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 4px;
  }

  .dropdown-item.open .dropdown-content {
    display: block;
  }

  .flag-icon {
    width: 20px;
    height: 20px;
    margin-right: 10px;
  }

  .product-item {
    margin-bottom: 5px;
  }

  .product-icon {
    width: 20px;
    height: 20px;
    margin-right: 10px;
  }
  
  .country-title {
    font-family: Arial, sans-serif;
    font-size:20px;
    text-align: center;
    font-weight: bold;
    color: #ffffff;
  } 

</style>
  <div class="dropdown-menu">
    <p class="country-title" alt="Countries where this product is available">Country Availability</p>

    <div class="dropdown-item">
      <button class="dropdown-toggle" onclick="toggleDropdown(event)" alt="Drop down menu displaying the available countries for this product">
        <b>Country List</b> ⬇️
      </button>
      <div class="dropdown-content">
        <div class="product-item">
          <img src="https://files.readme.io/a4c8b3d6596d943e2b93c82cb1d432a2edaf6998667835c2e97ef4a31d460c7e-us-circle-01.png" alt="USA" class="flag-icon">
          USA
        </div>
        <div class="product-item">
          <img src="https://files.readme.io/3ca294a1b4b8b8506c3ff32876abc6e3e33d0e65a509dab81398915094bdbc5c-61TcZ33ZrJL._AC_UY1000_.jpg" alt="Canada" class="flag-icon">
          Canada
        </div>
        <div class="product-item">
          <img src="https://files.readme.io/db98461fef617df7c9970e98f01150f067fcee1fc823a450f09056138b9f70be-united-kingdom-flag-rounded-icon-uk-flag-union-jack-vector.jpg" alt="UK" class="flag-icon">
          UK
        </div>
      </div>
    </div>

  </div>
`}</HTMLBlock>

## Overview

Transactions can move through a series of states from capturing to refunding a transaction. Some e-commerce platforms or order management systems may not support all transaction actions so be sure to check their documentation.

<Image title="Transaction_states_Isoflow_Diagram_7_8_2021.png" alt="Authorized to Voided, Authorization Expired, or Captured. Captured to refunded (partial) or refunded (full)." align="center" width="smart" src="https://files.readme.io/7c8b6b1-Transaction_states_Isoflow_Diagram_7_8_2021.png" />

## States

Transactions can go through the following states:

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Transaction status
      </th>

      <th>
        Description
      </th>

      <th>
        What Affirm does
      </th>

      <th>
        Available actions
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **authorized**
      </td>

      <td>
        The transaction is authorized. By default, the authorization expires after 30 days.
      </td>

      <td>
        * Generates Transaction ID  
        * Renders transaction in merchant dashboard  
        * Messages authorization to the customer
      </td>

      <td>
        `capture` `void` `read` `update`
      </td>
    </tr>

    <tr>
      <td>
        **voided** 
      </td>

      <td>
        The transaction is voided, or the authorization has expired. No further actions can be taken on this transaction.
      </td>

      <td>
        Messages the customer that transaction has been voided
      </td>

      <td>
        `read`
      </td>
    </tr>

    <tr>
      <td>
        **captured** 
      </td>

      <td>
        The transaction is captured, and the merchant will receive their funds. The user will begin payments 30 days after the capture.
      </td>

      <td>
        * Transfers funds to the merchant within 2-3 business days  
        * Sends invoice to the customer for the first payment due in 30 days  
        * Messages confirmation to the customer
      </td>

      <td>
        `read`\
        `refund`\
        `update`
      </td>
    </tr>

    <tr>
      <td>
        **partially\_refunded** 
      </td>

      <td>
        The transaction has been partially refunded and there is still a positive balance on the loan.
      </td>

      <td>
        * User receives a message:\
          "Affirm refund confirmed for (amount) from (merchant). View more details at [https://www.affirm.com/account"](https://www.affirm.com/account")  
        * Affirm will withhold refunded amount from next settlement
      </td>

      <td>
        `refund`\
        `read`\
        `update`
      </td>
    </tr>

    <tr>
      <td>
        **refunded** 
      </td>

      <td>
        The transaction has fully refunded and there is a zero balance on the loan.
      </td>

      <td>
        * User receives a message:\
          "Affirm refund confirmed for (amount) from (merchant). View more details at [https://www.affirm.com/account"](https://www.affirm.com/account")  
        * Affirm will withhold refunded amount from next settlement
      </td>

      <td>
        `read`
      </td>
    </tr>

    <tr>
      <td>
        **disputed** 
      </td>

      <td>
        A dispute has been opened and is active.
      </td>

      <td>

      </td>

      <td>
        none
      </td>
    </tr>

    <tr>
      <td>
        **dispute\_refunded** 
      </td>

      <td>
        A dispute has been resolved in the customer's favor and the transaction has been refunded.
      </td>

      <td>

      </td>

      <td>
        none
      </td>
    </tr>
  </tbody>
</Table>

# Sibling pages

* [Authorize and Capture Transactions](https://docs.affirm.com/developers/docs/manage-transactions.md)
* [Read, Void, Refund, and Update Transactions](https://docs.affirm.com/developers/docs/read-void-refund-and-update-transactions.md)
* [Manage Split Capture Transactions](https://docs.affirm.com/developers/docs/split-capture-transactions.md)