Affirm

Offer Affirm pay later payments.

Offer Affirm pay later payments in USD through a direct connection to Affirm. Checkout is a redirect: the customer completes the Affirm checkout and returns to Hyperswitch, which then confirms the transaction. Payments support sequential automatic or manual capture, and refunds are supported. Mandates are not supported.

Status and capabilities

Integration status: beta

Category: payment gateway

Webhook flows: None declared in code

Payment method	Type	Mandates	Refunds	Capture methods	Countries	Currencies
pay later	Affirm	not supported	supported	sequential automatic, manual	-	USD

The Countries column is empty because the direct Affirm connector's payment method filter restricts currency to USD but sets no country. Hyperswitch calls Affirm's US API (api.affirm.com), so use this connector for US Affirm merchant accounts. See the payment method filter and the production base URL.

Authentication

Supply a Public Key and Private Key. Hyperswitch joins them in that order as <Public Key>:<Private Key>, Base64-encodes the pair, and sends Authorization: Basic <encoded value>. See AffirmAuthType::try_from(), build_headers(), and get_auth_header().

Before you start

1. Sign in to the Hyperswitch control center.

2. Get your Public Key and Private Key from API keys in the Affirm merchant portal: sandbox or production. Keep the Private Key server-side only. See Affirm API keys.

To connect Affirm to your Hyperswitch account, follow Activate a connector on Hyperswitch, then return here for what Affirm supports.

Webhooks

Affirm webhooks are not supported. Use payment sync and refund sync for status updates. The connector's webhook handlers all return WebhooksNotImplemented; see IncomingWebhook for Affirm.

Source reference

Checkout, authentication, and webhook behavior on this page is tied to Hyperswitch d8b6ebe773690aa37cf249b2992c2358dbd7f438. See Affirm connector source and Affirm transformers.