Affirm is a popular payment method in the US and Canada that gives your customers a way to split purchases over a series of payments. Pay in 4 interest-free installments or in monthly installments of up to 36 months.
To pay with Affirm, customers are redirected to Affirm’s site, where they authorize the payment by agreeing to the terms of a payment plan, then return to your website to complete the order. Affirm offers payment options based on factors such as customer credit, prior account history, order amount, and the type of goods or services being underwritten. After payment acceptance, the full amount of the order (minus fees) is made available to your Stripe account upfront, and Affirm collects the purchase amount from your customer, who repays Affirm directly over time.
You don’t actually have to integrate Affirm and other payment methods individually. If you use our front-end products, Stripe automatically determines the most relevant payment methods to display. Follow a quickstart for one of our hosted UIs:
After setting up your payment form, activate the payment methods you want using the Stripe Dashboard.
Payment Links also supports adding Affirm from the Dashboard.
If you prefer to manually list payment methods, learn how to manually configure Affirm as a payment.
You can also let customers know Affirm payments are available by including the Payment Method Messaging Element on your product, cart, and payment pages. We recommend adding a site messaging Element to help drive conversion.
Depending on the cart order size, Affirm presents customers with Pay in 4, monthly installments, or both.
- Pay in 4: customers pay for purchases in four or fewer interest-free, bi-weekly payments over an 8 week term. Available for cart sizes between $50 and $250*.
- Monthly Installments: customers pay for purchases over a longer term of up to 36 months, which might include interest. Available for cart sizes between 100 USD and 30,000 USD*.
* Term lengths and cart ranges are determined by Affirm and may change at their discretion.
Prohibited and restricted business categories
In addition to the categories of businesses restricted from using Stripe overall, the following categories are prohibited from using Affirm.
- Business to business services
- Home improvement services, including contractors and special trade contractors
- Titled goods and auto loans, including entire cars, boats, and other motor vehicles (parts and services allowed)
- Professional services (including legal, consulting, and accounting)
Healthcare services are approved to use Affirm, however they’re subject to additional requirements. For the complete list of prohibited businesses and additional requirements, see the Affirm Payment Terms.
Adding Affirm branding to your website
Use the Payment Method Messaging Element on your site to let customers know that you offer Affirm ahead of checkout. You must comply with Affirm’s marketing compliance guides and use the Affirm toolkit that relates to the Affirm payment options you offer your customers.
Returns are subject to the return policy that you display on your website. If your business allows returns, you can refund Affirm transactions as you normally would for card payments. Affirm supports partial or full refunds for up to 120 days after the original purchase, and processes them asynchronously. After Stripe initiates a refund, Affirm pauses the customer’s payment plan and refunds the customer for any payments they’ve already made, minus any interest paid. Stripe doesn’t credit back the processing fees in the event of a refund.
Disputes and fraud
Customers must authenticate Affirm payments by logging into their Affirm account. This requirement helps reduce the risk of fraud or unrecognized payments. While Affirm covers losses incurred from customer fraud, Stripe might contact you on behalf of Affirm and request to stop or pause shipment before any losses are incurred. Comply promptly with these requests.
Customers can dispute Affirm payments in certain cases—for example, if they receive faulty goods or don’t receive them at all. Customers have up to 60 calendar days from the date of purchase to file a dispute. The dispute process works like this:
After the customer initiates a dispute, Stripe notifies you using:
- Email notification
- Stripe Dashboard
- An API
charge.dispute.createdevent (if your integration is set up to receive webhooks)
Stripe holds back the disputed amount from your balance until Affirm resolves the dispute, which can take a maximum of 30 calendar days from dispute creation.
Stripe requests that you upload compelling evidence that you fulfilled the purchase order using the Stripe Dashboard. This evidence can include:
- Received return confirmation (for shipped goods returned from the customer to you)
- Tracking ID
- Shipping date
- Record of purchase for intangible goods, such as IP address or email receipt
- Record of purchase for services or physical goods, such as phone number or proof of receipt
If you would rather handle disputes programmatically, you can respond to disputes using the API.
This information helps Affirm determine if a dispute is valid or if they should reject it. Make sure the evidence you provide contains as much detail as possible from what the customer provided at checkout. You must submit the requested information within 15 calendar days. Affirm makes a decision within 15 calendar days of evidence submission. If Affirm resolves the dispute with you winning, Stripe returns the disputed amount to your Stripe balance. If Affirm rules in favor of the customer, the balance charge becomes permanent.
After a customer uses Affirm to make a purchase, Affirm emails the customer with updates. These updates include information about the following events:
- Affirm confirms or denies a loan. Affirms sends these updates when the payment_intent succeeds or when Affirm denies the loan.
- A refund completes.
- A payment is cancelled, which results in Affirm cancellling the loan.
- The customer completes a payment as part of the payment plan.
Affirm only sends email updates about Affirm’s loan issuance to your customer. You should continue to separately send emails related to the purchase such as order confirmation and shipping updates.
Request Affirm capability
Make sure you request the
affirm_payments capability and it’s set to
active on both your platform account and any connected accounts you want to enable.
Set correct MCC
Stripe and Affirm rely on merchant category codes (MCC) to determine eligibility of the connected accounts against the Affirm prohibited business categories. Make sure that you set correct MCCs for your Custom and Express accounts.
Merchant of record
The charge type of Connect payments might change the merchant name that appears on Affirm’s website or app during the redirect. The merchant of record determines the Stripe account authorized to create payments with a particular PaymentMethod.