Messaging with buttons

DocsCurrent

Last updated: Oct 30th, 7:00am

Integrate messaging directly with your buttons to promote Pay Later offers and other PayPal value propositions to your customers. Adding messaging can help improve conversion and attract new customers.

image

Know before you code

Required
Prerequisites

This feature modifies an existing checkout integration and uses the following:

Optional
Explore PayPal APIs with Postman

You can use Postman to explore and test PayPal APIs. Learn more in our Postman guide.

1

Add messaging to buttons

Include your messaging options to the buttons configuration object. Learn more about the full list of available options by reviewing the JavaScript SDK reference page. To display the strongest message to the customer, use message.amount with the current total based on the product or cart.

Note: The message.amount option functions independently from the captured order total and has no impact on it.

    1const buttons = paypal.Buttons({
    2 message: {
    3 amount: 100, // Update to your cart or product total amount
    4 align: 'center',
    5 color: 'black',
    6 }
    7});
    8buttons.render('#paypal-button-container');

    Button Examples

    The message content adapts to the buttons that are displayed:

    Description Options Buttons
    Vertical Stack

      1paypal.Buttons({
      2 style: { layout: "vertical" },
      3 message: { amount: 100 }
      4});

      Note: The message is positioned to the top to make room for the text that accompanies the debit/credit Card button.

      image
      Horizontal Stack
        1paypal.Buttons({
        2 style: { layout: "horizontal" },
        3 message: { amount: 100 }
        4});
        image
        Standalone PayPal
          1paypal.Buttons({
          2 fundingSource: paypal.FUNDING.PAYPAL,
          3 message: { amount: 20 }
          4});
          image
          Standalone Pay Later
            1paypal.Buttons({
            2 fundingSource: paypal.FUNDING.PAYLATER,
            3 message: { amount: 100 }
            4});
            image

            Learn more about standalone button integration best practices by reviewing the Standalone Buttons page.

            2

            Update the message amount

            As the product count or cart total changes, you can update the message.amount to reflect the latest total.

              1buttons.updateProps({
              2 message: {
              3 amount: 200, // Update to your cart or product total amount
              4 align: 'center',
              5 color: 'black',
              6 }
              7});
              3

              Complete your integration

              Return to the Set up standard payments guide to create and capture the order.

              We use cookies to improve your experience on our site. May we use marketing cookies to show you personalized ads? Manage all cookies