Configure Affirm

This guide walks you through configuring Affirm at checkout in VTEX.

Configure Affirm

1. Sign into your VTEX store admin.
2. Navigate to Payments > Settings.
3. In the Gateway Affiliation tab, update the following:

FieldDescription
Affiliation Nameset to Affirm
Test - Live/ProductionIf you wish to do sandbox testing, change the toggle to Test. For production, set to Live/Production.
Application KeyYour Affirm public API key. (If testing, enter your sandbox public API key).
Application TokenYour private API key. (If testing, enter your Affirm sandbox private API key).
Auto Settlement:* Use Payment Processor Recommended Behavior: the settings in the Affirm integration app determine the timing of auto-settle and auto-cancel. Do not select this option unless instructed by Affirm.
* Immediately: Auto Settle Upon Payment Authorization: the settlement/capture process is started immediately after the payment is authorized.
* Immediately: Auto Settle Once Risk Analysis Has Been Approved: if the client uses a third party anti-fraud service, the settlement/capture process is started immediately after the anti-fraud process is completed. If you do not have anti-fraud service configured, this option behaves the same as the previous option.
* Disabled: Do Not Auto Settle: settlement/capture needs to be manually triggered.
1276

4. Install the VTEX Payment App in your account by running vtex install vtex.affirm-payment (Details on installing an app in VTEX can be found here).
5. Configure the app settings by browsing to Apps > My Apps in your account's admin sidebar and then selecting "Affirm Payment".
6. Complete the following options:

FieldDescription
Enable KatapultSet this to True only if instructed by Affirm.
Company Name (optional)If you have multiple sites operating under a single Affirm account, you can override the external company/brand name that the customer sees. This affects all references to your company name in the Affirm UI. Leave blank to use your default company name stored in your Affirm account.
Public API Key for promotional componentsEnter the public API key. provided to you by Affirm. (if testing, enter the sandbox public API key.)
Production Mode for promotional componentsDetermines if the components from the Affirm Components app run in Production or Sandbox mode.
Interval to use for the following three settingsDetermines the unit of time used by the following settings. Leave default value (Days) unless instructed by Affirm.
Delay to auto-settleNumber of minutes/hours/days before authorized Affirm payments are automatically settled. Leave default value (30) unless instructed by Affirm.
Delay to auto-settle after anti-fraudNumber of minutes/hours/days before authorized Affirm payments are automatically settled after merchant's antifraud approval. Leave default value (30) unless instructed by Affirm.
Delay to cancelNumber of minutes/hours/days before Affirm payments are automatically canceled. Leave default value (30) unless instructed by Affirm.
Katapult public tokenThe public API token for your Katapult account. This is only needed if Katapult is enabled.
Katapult private tokenThe private API token for your Katapult account. This is only needed if Katapult is enabled.