Enable the Stripe Payment Method Messaging element by loading Stripe.js and initializing a paymentMethodMessaging element with the amount, currency, and the BNPL payment methods you want to promote (e.g., afterpay_clearpay, klarna, affirm).
Mount the messaging element in your product detail page and cart page; Stripe.js automatically renders the appropriate installment messaging for the eligible methods based on the amount and buyer's country.
Update the amount in the messaging element dynamically when the cart total changes so the installment amounts displayed stay accurate.
Ensure your checkout page lists the same BNPL methods in the PaymentElement so customers who see the messaging on the product page can complete the purchase with BNPL.
Test the messaging element across different amounts to verify it hides when the purchase amount is below the minimum threshold for each BNPL provider.
Comply with each BNPL provider's messaging guidelines: some require specific phrases and logos; Stripe's element handles compliance automatically for supported providers.
Known gotchas
Payment method messaging is only available for certain currencies and countries; verify which BNPL methods are eligible for your merchant country and the buyer's country before enabling them.
BNPL messaging should reflect the actual payment schedule accurately; if your integration applies discounts or taxes after the messaging element initializes, update the amount to avoid misleading installment figures.
Some BNPL providers require additional merchant approval before you can display their messaging; confirm your account is approved for each method, not just approved for Stripe in general.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?