Skip to main content

 

Affirm Merchant Help

Affirm Connect Merchant Object

The merchant object contains the user_confirmation_url and user_cancel_url. The customer goes to the user_confirmation_url if the user is approved and confirms their loan. The user goes to the user_cancel_url in all other cases, such as voluntary cancel, credit decline, identity verification issue, etc. 

"merchant": {
    "user_confirmation_url": "https://merchantsite.com/confirm",
    "user_cancel_url": "https://merchantsite.com/cancel",
    "user_confirmation_url_action": "POST",
    "name": "Your Customer-Facing Merchant Name",
    "exchange_lease_enabled": true,
  },
user_confirmation_url

required url.

URL that the customer is sent to if they successfully complete the Affirm checkout flow.

A checkout_token will be sent to this URL in the POST request, and that checkout_token should be used to authorize the charge before the user is redirected to the order confirmation page.

Analytics tags are other query string parameters can be persisted here as well. Read more here.

user_cancel_url

required url.

URL that the customer is sent to if the customer exits the Affirm checkout flow. This is the same if the user voluntarily cancels or closes the window before completion, or if the user is denied. You should setup the cancel_url to be the checkout payment page, and you can also append analytics tags to the URL to help you identify who you may want to reach out to about alternative payment methods or reapplying.

Analytics tags are other query string parameters can be persisted here as well. Read more here.

user_confirmation_url_action

optional string.

Accepted values are: 'GET', 'POST'. Defaults to 'POST'. Read more here.

name

options string

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.

exchange_lease_enabled

optional boolean

An override option that determines whether the customer, if declined for a loan by Affirm, will be provided an option to lease the purchase from an alternative financing provider.

This field is intended to be used by merchants seeking to conduct their own A/B test before fully adopting alternative financing within Checkout.