Pay later cross-border messaging

Overview

Cross-border messaging is a PayPal feature that you can use to promote Pay Later offers to customers of a country that differs from the country of your PayPal account by including the buyerCountry parameter in your message configuration.

Eligibility

To promote Pay Later offers for the following countries, you must be approved by PayPal and meet the following criteria.

Additionally, you must meet the standard eligibility criteria for Pay Later messaging, which can be found in the Overview section of your regional Pay Later messaging developer documentation.

Integration

1. Integrate the PayPal JavaScript SDK with the 'messages' component

View your region’s developer documentation for Pay Later offers by using the country selector on the Pay Later Messaging page.

2. Render the messages with the buyerCountry parameter

Determine where the SDK should render messaging, and PayPal determines the best Pay Later message to display on your website. You can control the format of the message using configuration attributes.

buyerCountry

The buyerCountry parameter is used to identify your intended consumer base and needs to be included with each message you place on your website. If you have a reliable way of identifying the consumer's country of origin on your website, ensure that the buyerCountry is updated appropriately to render the most relevant Pay Later message to your consumers.

Example for a non-US merchant promoting US Pay Later via Inline HTML attributes:

1<div data-pp-message data-pp-placement="product" data-pp-amount="500.00" data-pp-buyercountry="US"/>

Example for a non-US merchant promoting US Pay Later via Javascript configuration:

1<script>
2    paypal.Messages({
3        amount: 500,
4        placement: 'product',
5        buyerCountry: 'US',
6    })
7    .render('.pp-message');
8</script>

3. Go Live

Test your message locally and check if your website displays the message correctly. Then push the changes to your live site to tell your customers that financing is available.