About Affirm Virtual Card
Learn more about Affirm Virtual Card and adding Affirm on your website and mobile app.
Overview
With our Virtual Card product, Affirm offers a broad selection of integration options and features for a seamless, customized, and unique experience for your customers.
Virtual Cards are a one-time use prepaid debit card with a fixed total available balance. Check out these benefits of the Affirm Virtual Card:
- Real-time credit decision.
- No hard credit inquiry.
- Merchant-defined minimum cart threshold.
- Merchant-defined product offering (i.e., AffirmGo, zero percent financing, interest-bearing financing, or a mix of these offerings).
- You can process Virtual Cards via your existing card processing system.
- Once a Virtual Card is issued, it can’t be used at a different merchant.
use_vcn
AttributeOn the client-side, the Virtual Card product integration is virtually identical to our Direct product. The minor difference is that we pass an additional attribute,
use_vcn
, in the request to issue a virtual card on the loan.
The Customer Experience
-
Customer begins the Affirm application flow and enters the requested loan amount.
-
If the customer is:
- An existing Affirm user, they enter their phone number to log in to their existing account.
- A first time user, they enter their first and last name, email address, mobile phone number, birth date, and last 4 digits of SSN to create their account.
-
We process the customer's Affirm application to render a real-time credit decision.
-
When the customer’s application is approved, the customer sees the approved loan amount, available monthly payment options, and other key loan terms (e.g., APR and amount of a down payment in the off chance this is required).
Note: If a customer’s application isn’t approved, we immediately notify them of the decision in the checkout flow and send them a secure message with additional context. -
Customer completes the checkout process.
Note: Customers can only use a Virtual Card once towards the purchase associated with the original loan request. Virtual Cards can’t be used at a different merchant, and they expire if they’re not authorized within 24 hours of issue.
The Merchant Experience
Checkout Flow
This diagram shows how your client, your server, and Affirm interact for client-side integrations via web or mobile:

- Online Checkout:
- A customer checks out.
- Your client sends the customers’ order details client-side to Affirm.
- We render the checkout experience for the customer.
- We return a
checkout_token
in the success callback on their loan confirmation.
- Create an Order: Your front-end creates the order by sending the checkout_token to your server via
POST
,GET
, or a Webhook. -
- Retrieve the Card Details:
- Client-side: Upon loan confirmation, we return the
checkout_token
and card details in the success callback. - Server-side: Upon loan confirmation, we return the
checkout_token
in the success callback to your front-end. Your server code receives the checkout_token and then uses Affirm’s Read Card endpoint to retrieve the card issued for that loan.
- Client-side: Upon loan confirmation, we return the
- Process the Virtual Card: Using your existing payment gateway integration, you pass the virtual card details like any other payment card for authorization, capture, and refund.
Affirm BINs
Transactions via an Affirm Virtual Card should be labeled and identified using our unique Bank Identification Number (BIN), or any other flag you choose from the custom logic you built to handle them. The full list of BIN numbers that Affirm may return:
Visa USA BINs
- 48650700
- 42883400
- 4672250
- 4672260
- 4672270
- 402086
- 481174
- 42460512
- 428813512
- 42881304
Visa Canada BINs
- 480411009
Google Pay BINs
- 428813513
- 42881304
- 428813512
- 42881306
Recommended Topics
Updated 6 days ago