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 possible transaction states for an order. Some e-commerce platforms or order management systems may not support all transaction actions so be sure to check their documentation.

States

Transactions can go through the following states:

Transaction status	Description	What Affirm does	Available actions
authorized	The transaction is authorized. By default, the authorization expires after 30 days.	Generates Transaction ID Renders transaction in merchant dashboard * Messages authorization to the customer	`capture` `void` `read` `update`
voided	The transaction is voided, or the authorization has expired. No further actions can be taken on this transaction.	Messages the customer that transaction has been voided	`read`
captured	The transaction is captured, and the merchant will receive their funds. The user will begin payments 30 days after the capture.	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	`read` `refund` `update`
partially_refunded	The transaction has been partially refunded and there is still a positive balance on the loan.	User receives a message: "Affirm refund confirmed for (amount) from (merchant). View more details at https://www.affirm.com/account" Affirm will withhold refunded amount from next settlement	`refund` `read` `update`
refunded	The transaction has fully refunded and there is a zero balance on the loan.	User receives a message: "Affirm refund confirmed for (amount) from (merchant). View more details at https://www.affirm.com/account" Affirm will withhold refunded amount from next settlement	`read`
disputed	A dispute has been opened and is active.		none
dispute_refunded	A dispute has been resolved in the customer's favor and the transaction has been refunded.		none