Charge states

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