Articles in this section

Set up a connection to Affirm

Tanisha Ray
Updated

Affirm is a financial technology company that provides alternative lending solutions, offering consumers the option to make purchases and pay over time through flexible payment plans.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your Affirm account API type:

  • Transaction checkout and charges: Create and manage Affirm transactions by initiating checkout, capturing tokens, authorizing charges, and handling refunds or order updates to support the full payment lifecycle.

  • Cards: Issue, finalize, or cancel virtual cards tied to Affirm loans to support flexible, secure payment experiences in virtual card-based integrations.

The following settings are common for all API types

Environment * 

Select your Affirm account environment:

  • Live: if your account URL is https://api.affirm.com.

  • Sandbox: if your account URL is https://sandbox.affirm.com.

Public API key * 

Enter your Affirm public API key.

 How to retrieve the public API key

Private API key * 

Enter your Affirm private API key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your API key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the private API key 

The following setting is visible only for the Transaction checkout and charges API type

API version

Select your Affirm account API version (either v1 or v2).

The following setting is visible only for the Cards API type

Checkout ID * 

Enter your checkout ID.

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Basic universal connector documentation.

How to retrieve the public key and private API key

  1. Sign in to your Affirm account. 

  2. Navigate to API keys.

  3. Copy the Public API key. 

  4. Copy the Private API key. For detailed information, see API keys.

Additional references