Messaging with buttons

DocsCurrent

Last updated: Apr 30th, 4:12pm

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

Note: Messaging is currently only supported for US merchants and US customers. Merchants must be eligible for Pay Later to display Pay Later offers with buttons. Other PayPal value propositions will still show if ineligible for Pay Later.

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:

Vertical Stack

image

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

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

Horizontal Stack

image 

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

Standalone PayPal

image 

1paypal.Buttons({
2  fundingSource: paypal.FUNDING.PAYPAL,
3  message: { amount: 20 }
4});

Standalone Pay Later

image 

1paypal.Buttons({
2  fundingSource: paypal.FUNDING.PAYLATER,
3  message: { amount: 100 }
4});

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});

Note: Ensure that all previously specified message options are passed into updateProps including any options that have not changed; otherwise, they will be overwritten with default values.

3

Complete your integration

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

Know before you code

Standard Checkout

Required
This feature modifies an existing standard Checkout integration and uses the following:

JavaScript SDK: Adds PayPal-supported payment methods

Orders REST API: Create, update, retrieve, authorize, and capture orders.

Read the standard checkout guide

Explore PayPal APIs with Postman

Optional

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

Run in Postman

See also