Charge States

Learn about Affirm's 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 statusDescriptionWhat Affirm doesAvailable actions
authorizedThe 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 voidedread
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