Pay with PayPal for one-time payments
Last updated: Jan 30th, 4:25pm
Pay with PayPal's one-time payment flow provides a one-click solution to accelerate your buyer's checkout experience by skipping manual data entry.
End-to-end one-time payments flow
Purpose
This guide shows best practices for merchants using Pay with PayPal to accept one-time payments for physical and digital goods. Setting up the PayPal button and PayPal review page using these tips can help improve engagement, reduce cart abandonment, and ensure a secure transaction experience.
Who is this guide for?
Developers, designers, and product managers building ecommerce solutions for businesses selling physical goods, including retail, apparel, electronics, and other tangible products.
Best practices for end-to-end Pay with PayPal buyer experience
The PayPal button and PayPal review page help you accept one-time payments. This guide shows how to present the PayPal button and PayPal review page to improve the buyer flow.
Per our User Agreement, you are required to follow certain standards when presenting PayPal or Venmo payment methods. You must treat PayPal and Venmo payment methods equally to other payment methods at your points of sale, including logo placement, payment flow, and fees. You need to show the PayPal and Venmo services prominently in the checkout experience, and don't present any other payment methods earlier in the checkout flow.
Best practices
Place checkout buttons on your cart and product details pages so buyers can start checkout whenever they're ready.
- Ensure that the PayPal button shows up earlier in the checkout experience, ahead of any other merchant-provided checkout flows that require data entry from the user.
- Place PayPal Pay Later messaging close to the order total so buyers can see it clearly as a financing option. See Message placement for more information.
-
Be sure to pass the
data-page-type
through the JavaScript SDK to indicate the type of page where you place the button. Thedata-page-type
parameter helps PayPal optimize button behavior based on page types. See the JavaScript SDK script configuration page for more information.

Optional placement
You can place the PayPal button upstream, such as on the product description page, to encourage quick, single-product checkouts.
- Ensure any modifiers for items show up ahead of the PayPal button.
- Pay Later messaging shows buyers that they can buy now and pay later if they check out with PayPal. Adding Pay Later messaging to your website can help improve conversion, attract new customers, and increase order values.

Note: The callback may not be necessary when shipping fees don't change or aren't applicable.
Enable shipping options callback
Allow buyers to choose a delivery method during checkout. Use the shipping options callback to update the cart amount based on the selected shipping option.
If you don't integrate shipping options, PayPal can't display your delivery options. The buyer must return to the site to select delivery options before completing the transaction.
See the Shipping module page for more details.
Tip: Use the shipping options callback for physical goods even when only one delivery method is available.
This callback applies to upstream flows where the buyer has not already selected a shipping method for their order, such as when the user clicks the PayPal button on the merchant cart page.
Checkout presentment
If the buyer chooses to proceed manually through merchant checkout, have the user enter their shipping details, select their shipping method, and provide any other required details before presenting the PayPal button.
Best practices
We recommend the following best practices:
- Set up your checkout flow to identify PayPal users and proactively select the PayPal payment option to reduce decision fatigue for customers ready to complete their purchases.
- Clicking the PayPal button should be the buyer's last action in your checkout experience.
- After the buyer approves the transaction on the PayPal Checkout experience, redirect the buyer to the order success page.
- For transactions initiated from merchant checkout pages, pass the buyer's provided shipping address and contact information in the Create order call.
-
Set the shipping preference in the Orders API to
SET_PROVIDED_ADDRESS
so the buyer can't change the shipping address during checkout. See the Shipping module page for more information.

Implementing PayPal to deliver the highest conversion
Optimize your buyer's PayPal login experience
Best practices
- If you have the buyer's email address, pass it in the Create order call. See the Pass buyer identifier guide for more information.
- For merchants showing PayPal in web view, ensure the PayPal payment experience is always full height and never presented in an iframe.

Optimize your buyer's PayPal Checkout experience
Best practices
For all transactions:
- Include a Pay Now button on the PayPal review page so the buyer can complete the transaction in a checkout hosted by PayPal and then return to an order success or receipt page.
- Set up the PayPal review page to create the order when the buyer selects Pay Now. See the Orders v2 API for more details.
- Ensure no more buyer action is needed after they complete payment through the PayPal review page.
- For transactions initiated from merchant checkout pages, pass the buyer's provided shipping address and contact information in the Create order call. See the Pass buyer identifier guide for more information.
- For transactions initiated from upstream, such as cart and product pages, create the order with all supported shipping options when applicable. Integrate with shipping callbacks to calculate the shipping options, cost, and taxes based on the buyer's selected address. See the Shipping module page for more details.
- Pass the invoice line item and SKU details through the Create order request. PayPal displays these details during checkout, which enhances buyer experience, provides greater transparency, increases conversion, and minimizes disputes as buyers can verify the specifics of their purchase. See the Pass line-item details page for more information.

Pay Now flow