Skip to main content

Charges (Transaction) Events and Statuses

  • Updated

Contents

 

Transactions, also known as Charges, represent the Affirm loans that are issued to the end-user. You can interact with charges via the Charges page (shown below), or through our API. When you sign in to the Merchant Dashboard, you'll see the most recent charges. You can also view the charges in more detail from the Charges menu item.

 

To better understand charges and learn how to navigate the charges tab, view this article.

To learn how to process charges, view this article.

 

 

 

Charges Page

 

All charges that show up, by default, are displayed in reverse chronological order by Date Confirmed. Also associated with charges are a Loan ID, Customer Name, Status, and Total. We'll be paying attention to charge status, what they mean, and what actions you can perform on them.

Charges_01.png

 

Back To Top

 

Charge Events

 

There are four main events that Affirm can do with a charge: Capture, Void, Refund, and Update. These occur through your platform integration, or through our API (if you use our Direct API method to integrate with Affirm). The event details are as follows:

Action Description
Capture
  • Confirms and issues the authorized loan
  • Begins bank settlement to your account
  • Occurs at fulfillment
Void
  • Voids and cancels an authorized, but it must be an uncaptured loan
Refund

  • Refunds part or all of a captured loan

  • Will be deducted from that day’s ACH total transfer
Update
  • Updates the shipping or order information for the charge
  •  

 

Back To Top

 

Charge Statuses

 

While there are four primary actions that Affirm can do with a charge, there are a few more statuses that can provide you with more detail.

 

Charge statuses generally follow this flow:

Charge_States.png

 

To better understand each charge status, you can click into an individual charge to view the details. Below are what the statuses mean, and what you can action on a charge with that status:

 

  • Authorized: The loan is authorized and ready for capture. You can Capture Charge or Void Charge. 
    Charges_06.png

  • Captured: The loan has been captured and settlement can occur. You can enter an amount to Refund.
    Charges_07.png

  • Authorization Expired: The loan has not been captured and has exceeded the authorization expiration date (the default being 30 days).

 

  • Voided: An authorized loan has been voided and canceled. You can't take any action here, but you can see an event log of when the charge was voided.
    Charges_08.png

  • Partially Refunded: Part of the authorized loan has been refunded. If further adjustments are necessary, you can add another refund.
    Charges_09.png

  • Refunded: The entirety of an authorized loan has been refunded. You cannot action further on this status, but you can see an event log.
    Charges_10.png

Outside of those charge states, you can also encounter disputes. This occurs when your customer experiences an issue with the loan. The states for charges under dispute are:

 

  • Disputed: A dispute has been opened and is active.
  • Dispute Refunded: A dispute has been resolved in the customer's favor and the charge has been refunded.

 

To learn more about disputes and how they are resolved, check out this article.

 

Back To Top

 

Related articles