Transaction States

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.

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