Payment Method Messaging Element
The Payment Method Messaging Element is a UI component for informing a customer about available buy-now-pay-later plans. It automatically determines the available plans and conditions, generates a localized description, and displays it in your form’s theme.

Create and mount the Payment Method Messaging Element
Dynamic display
The element dynamically displays payment plans that the customer is eligible for. These depend on the customer’s location and currency. They also depend on the amount of the payment, as in this example:
$0 | $99 | $500 |
When available, the interest-bearing loan payment plans are shown on a separate line from the pay-in-x plans, which might increase the space needed for the element.
Learn more modal
When the customer selects Learn more, the Payment Method Messaging Element displays a modal with details about buy now, pay later methods.

A preview of the Learn more modal
The modal includes:
- A timeline explaining the approval process
- A summary of terms for each available method
- A link to the full terms
Supported plans
The Payment Method Messaging Element supports these payment methods and payment plans:
Klarna | Afterpay | Affirm |
---|---|---|
|
|
|
It supports these values for countryCode
: US, CA, AU, NZ, GB, IE, FR, ES, DE, AT, BE, DK, FI, IT, NL, NO, SE
.
It supports these values for currency
: USD, GBP, EUR, DKK, NOK, SEK, CAD, AUD
.
Caution
Messaging does not render if the countryCode
and currency
combination passed has no eligible payment plans.
Appearance
Use the Appearance API to customize the font and logo of your messaging. You can select a theme as in the example below.
flat | night | stripe |
Use variables for additional customization.
const appearance = { variables: { colorText: 'rgb(84, 51, 255)', colorTextSecondary: 'rgb(28, 198, 255)', // "Learn more" text color fontSizeBase: '16px', spacingUnit: '10px', fontWeightMedium: 'bolder', fontFamily: 'Ideal Sans, system-ui, sans-serif', } };
The Payment Method Messaging Element is a tool that allows you to message various buy now, pay later payment options to your customers. You’re responsible for compliance with applicable laws, rules, and regulations regarding the promotion of buy now, pay later payment options.