---
updatedAt: 2025-11-13T14:34:32.000Z
agentTools:
  siteIndex: https://docs.affirm.com/llms.txt
  projectIndex: https://docs.affirm.com/developers/v1.0-Global-Integration/llms.txt
---

# Transaction States

Learn about Affirm's transaction states.

## Overview

Transactions can move through a series of states from capturing a transaction to refunding it. Here’s an overview of the different transaction states for an order. Some e-commerce platforms or order management systems might not support all transaction actions, so see their documentation to confirm.

<Image title="Transaction_states_Isoflow_Diagram_7_8_2021.png" alt={1032} 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 is 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/v1.0-Global-Integration/docs/authorize-and-capture-transactions.md)
* [Actions](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/actions.md)