Branding & Parity

• The complete PayPal experience, including PayPal logos and acceptance marks, is in parity with other payments methods across the integration.
• Use PayPal logos from official sources without modifications. PayPal logo assets can be downloaded from Media Resources.

PayPal Checkout

Implement Express checkout

Provide your app customers with more opportunities to make a purchase by adding PayPal checkout to the product or cart page. Users can select their preferred shipping options and address directly in the paysheet, which helps increase your overall checkout conversion rate.

Enable guest checkout with PayPal

PayPal allows users to easily checkout in a couple taps. You can use information provided by PayPal such as shipping address, and enable your customers to make a purchase swiftly. Enforcing new customers to register for an account prior to checkout often leads to cart abandonment.

• If you don’t require users to register a customer account, make sure PayPal is available for your guest customers.
• If you want to encourage users to register a customer account, offer the account signup after the purchase. Since the information is provided by PayPal, customers may simply need to confirm their password to set up an account.

Choose the correct button on the PayPal Review page

Display the correct button text on the PayPal review page to reflect the payment flow:

Pay Now	Continue
If the payment is executed after consumers click the button on PayPal payment page, set user_action to "PAY_NOW" to display a "Pay Now" or "Complete Order" button.	If the final amount is not known when the checkout flow is initiated and you want to redirect the customer to your page without processing the payment, set user_action to "CONTINUE" to display a "Continue" or "Review Order" button.

Present or hide shipping address

While PayPal offers the flexibility for merchants to customize the shipping address selection on the PayPal review paysheet, make sure to submit the correct shipping address your buyers choose to PayPal.

• For physical products, display customer’s shipping address on the PayPal page. You can choose whether you would like to allow your customers to change their shipping address.
• For digital products or services where a shipping address isn’t required, hid the shipping address on the PayPal page.

Listen for Shipping Changes

Use shipping callback to verify shipping addresses or update delivery options such as BOPIS (Buy Online, Pick up In Store) or shipping methods, while the customer is within the PayPal experience.

BOPIS	Shipping Callback - Update Options	Shipping Callback - Error

Use billing agreement only for recurring payments or subscriptions

Offer the most relevant commerce experience based on your products and services.

• Avoid initiating the billing agreement flow for your guest users’ single purchases. Prompting users to this contractual agreement where it isn’t needed may cause confusion and lead to cart abandonment.
• Use PayPal’s billing agreement flow to streamline your checkout, for example, allow users to:
  • Checkout with One-Click, by associating their PayPal account with your app to enable faster checkout for returning customers.
  • Make future payments automatically such as utilities and subscription services

Billing Agreement - With Purchase	Billing Agreement - Without Purchase

Display payment details

Pass the line items to PayPal so that the purchase details are viewable for your customers within the SDK during checkout and within their PayPal account. If you have a higher average cart value, providing this information leads to decreased cart abandonment.

SDK versions

We always recommend using the latest versions of our SDKs. While older versions may still be supported, in order to communicate securely with PayPal and to ensure the best user experience, we recommend having at least the SDK version of 0.112.

Latest SDK versions
iOS
Android