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 Attribute

On 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

  1. Customer begins the Affirm application flow and enters the requested loan amount.

  2. If the customer is:

    1. An existing Affirm user, they enter their phone number to log in to their existing account.
    2. 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.
  3. We process the customer's Affirm application to render a real-time credit decision.

  4. 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.

  5. 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.

Checkout flow for customers using virtual card on mobile

The Merchant Experience

Checkout Flow

This diagram shows how your client, your server, and Affirm interact for client-side integrations via web or mobile:

Checkout token from affirm server to your client to your server to affirm server
  1. Online Checkout:
    1. A customer checks out.
    2. Your client sends the customers’ order details client-side to Affirm.
    3. We render the checkout experience for the customer.
    4. We return a checkout_token in the success callback on their loan confirmation.
  2. Create an Order: Your front-end creates the order by sending the checkout_token to your server via POST, GET, or a Webhook.

  3. Retrieve the Card Details:
    1. Client-side: Upon loan confirmation, we return the checkout_token and card details in the success callback.
    2. 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.
  4. 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