Charge States (Legacy)

Overview

Charges can move through a series of states from capturing a transaction to refunding it. Here’s an overview of the different possible charge states for an order. Some e-commerce platforms or order management systems may not support all charge actions so be sure to check their documentation.

States

Charges can go through the following states:

Charge status	Description	What Affirm does	Available actions
authorized	The charge is authorized. By default, the authorization expires after 30 days.	Generates Charge ID Renders charge in merchant dashboard Messages authorization to the customer	`capture` `void` `read` `update`
voided	The charge is voided, or the authorization has expired. No further actions can be taken on this charge.	Messages the customer that charge has been voided	`read`
captured	The charge 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 charge 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 charge 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 charge has been refunded.		none