- Important Disclosures
- Affirm Overview
- Marketing Guidelines
- Dashboard and Settlement
- Integration Implementation (Platform Integration Method)
- Integration Implementation (Direct API Method)
Welcome to Affirm! We’re very excited to have you as a partner. This self-service onboarding program will outline all the necessary steps to successfully integrate Affirm with your e-commerce platform. But before we begin, please make sure that you have reviewed the following:
- If you have questions prior to starting with Affirm, you can consult this article.
- If you haven't signed up yet, please start with this article.
Each section will focus on a different component of the implementation process. Once the onboarding sections have been completed and Affirm has been successfully tested on your test environment, the Affirm Implementation Team will review your test (aka staging/development) site to ensure all components are ready for a go-live roll-out. If you have any questions during the onboarding process, please reach out to firstname.lastname@example.org.
Before getting into the process, it's important to read through these disclosures:
Your Affirm program must comply with applicable federal, state, and local fair lending laws, regulations, and regulatory guidance. The purpose of fair lending standards is to ensure that individuals seeking financing are treated fairly and consistently.
Generally, financing options must be offered to all qualified consumers without discrimination on basis of race, color, religion, national origin, sex, marital status, age (provided the applicant has the capacity to enter into a binding contract), the applicant’s receipt of income through a public assistance program, the applicant’s good faith exercise of a right under the federal Consumer Credit Protection Act, military status, sexual orientation, and other factors that may be prohibited under applicable state and local requirements.
Your Affirm program must also comply with the prohibitions of Title X of the Dodd-Frank Act and Section 5 of the Federal Trade Commission Act relating to unfair, deceptive, and abusive acts or practices. In essence, the terms and conditions of financing programs must be clearly and accurately communicated to consumers.
Violating any applicable consumer protection requirement is a breach of your agreement with Affirm and can be grounds for termination as an Affirm merchant (and may result in legal action).
We're ready to begin! We'll first quickly go over Affirm's benefits and basic functionality so you gain a better idea of what you'll be implementing.
Affirm is a consumer-friendly financing option allowing your customers to buy now and pay over time with no hidden fees. Below are some high level benefits for prospective customers who haven't used it before. Affirm is:
- Quick and easy
Checkout is simple at any store that accepts Affirm. Just enter a few pieces of information for a real-time decision.
- No Hidden Fees
Know up front exactly what you’ll owe, with no hidden costs and no surprises.
- Safe & Secure
Affirm connects directly to online stores. There’s no card number to steal, so your account stays secure.
- You’re In Control
Pick a loan that fits your budget. You’ll make real progress every month, and at the end of your loan you’re free and clear.
Affirm makes financing easy. Generally, here is how most scenarios play out when a customer decides to buy with Affirm:
- Customer Orders Product
Customer selects Affirm as a payment method and completes the transaction.
- Affirm Pays Merchant
Merchant is paid in full (less fees and refunds) after capture on a 24hr rolling basis.
- Customer Pays Affirm
Customer makes monthly or biweekly payments to Affirm for the duration of the loan.
- Affirm Covers the Risk
Affirm assumes repayment/fraud risk and can easily issue full or partial refunds.
Affirm offers your customers a fast checkout flow with a clean and intuitive interface. In this process they will be able to choose their payment plan, term length, interest rate and get a brief summary of the loan.
To view your customer's flow, click here.
This section provides an overview of Affirm’s marketing best practices and compliance guidelines. Educating customers about Affirm and adding monthly payment messaging (Starting at $X / month...) will positively affect their purchase intent, and naturally improve conversion and average order value.
As part of the launch process, the Affirm integration team will review the monthly payment messaging on the product and cart pages.
- For the full Affirm Marketing Compliance Training, click here.
- For further information on Affirm's marketing guidelines, click here.
Dashboard and Settlement
Once you've got a general marketing plan in place, you can now explore your Affirm Merchant Dashboard.
Log in / Authenticate
- To set your password and access your dashboard, locate the email with the subject "You Have Access to the Affirm Dashboard!" then click the Access Dashboard button.
- From there, you can set a password (must be 8 characters long). If your email is a Google email address, feel free to authenticate through the Sign In with Google button.
View authorized, captured, voided, and refunded charges
When you first log in to your dashboard, you will see an overview of all of the transactions that have come through your account, including the customer name, the loan status, and the loan total.
After clicking on a specific transaction, you will see the order and customer details, including: order ID, customer name, and shipping address.
Add additional dashboard users
To add a new user to your dashboard, follow the instructions below:
- From the Users tab within Settings, click on the blue “+” button.
- An “Add User” dialog box will appear (screenshot below).
- Enter a valid email address for the team member you want to add.
4. Once the user has been added, you will see a notification confirming the addition on the Users
5. The user will receive an email from Affirm notifying them that they have Merchant
Schedule settlement reports
To view your account’s settlement reports, follow the instructions below:
- Hover over the left-side navigation bar and click on Settlements.
- A list of settlements appears with the date initiated, sub totals, and total settled.
- The Date for these settlements is the date the settlement was initiated from our bank.
- You can download a settlement report or set up email reports to be sent on a daily, weekly or monthly basis.
The following describes the settlement timeline for when funds are transferred:
- At the beginning of a day, at time 00:00 UTC, we calculate the sum of all the previous day’s charges as the settlement total.
- Note: Any refunds processed will be netted out within a given day's settlement.
- Note: Any refunds processed will be netted out within a given day's settlement.
- If your total settlement balance is positive, then at 00:30 UTC, we mark the settlement payment for disbursement.
- At 21:30 UTC, Cross River Bank initiates an ACH transfer to your bank for the settlement amount.
- On the following day, by 03:00 UTC, we generate and deliver to you the settlement report that contains all of the charge actions (capture, refund, disputed, etc.).
- Within 1 to 3 business days of initiating the ACH payment, your bank will receive the ACH transfer by 21:30 UTC of that day.
The API Keys for the technical component of the integration will be available by clicking on the key icon on the left-hand panel.
Integration Implementation: Platform Integration Method
Using one of Affirm's platform integration methods is easy - it does not require any coding, and it's much simpler and quicker to implement over our Direct API method (shown below). If you want to watch the onboarding information in a kickoff video format, choose your platform below:
For an overview of our integration options, as well as a full list of the Platform Integrations that Affirm supports, please visit this article. For the major platform integrations (as seen in the list above), please check out this section.
Integration Implementation: Direct API Method
Direct API Integrations require some coding in order for it to work. There are a few things you must do to get this operational before you can deploy it to your productive account and thus have it be live for your customers.
Please review this overview article and these four steps to get your Direct API Integration online:
- Building a Direct API Integration - Step 1: Retrieving Your API Keys
- Building a Direct API Integration - Step 2: Development
- Building a Direct API Integration - Step 3: Testing Your Integration
- Building a Direct API Integration - Step 4: Deploying Your Integration