PayPal Continue Fast Checkout

PayPal Continue checkout with inline flow


PayPal Continue with inline flow launches the PayPal checkout experience in a pop-up window, without a full page redirect. That means the shopper will stay on the Merchant's checkout page until she/he finishes the complete checkout. There are two possibilities to utilize this kind of checkout. First with a standard checkout option on a payment page and second with a fast checkout option on the cart page.

Standard checkout on the payment page

Loading the PayPal button via COPY+PAY payment widget is just like loading any other brand, i.e. in step 2, PAYPAL_CONTINUE must be specified as a brand. In addition the inline flow must be set in wpwlOptions with inlineFlow : ["PAYPAL_CONTINUE"]

See an example below.

Fast checkout on the cart page

Sometimes you might want to display the PayPal button early on the payment workflow where you do not yet have a checkout ID. Usually, the shopper can decide whether to continue with the normal checkout, or to immediately pay with PayPal.

It is possible to display the PayPal Button first, decoupled from the checkout ID and create a checkout ID later. In step 2:

  • Use paymentWidgets.js without a checkout ID
    <script src=""></script>
  • Define a callback function in wpwlOptions.createCheckout to create a checkout
We will call the callback function once the PayPal button is clicked. The function should return a checkout ID, or a promise that will return a checkout ID. Specifically, the returned object can be any thenable object. In particular, both JavaScript Promise and jQuery Promise are supported.


wpwlOptions.createCheckout = function() {
    // Call your server to create a checkout e.g:
	 return $.post(host + "/v1/checkouts", {
    .then(function(response) {
        // Assume that your server returned the response containing checkoutId
        return response.checkoutId;

PayPal fast checkout options

For using the fast checkout you need to populate wpwlOptions.paypal.

ParameterMandatoryDescriptionDefault valueExamples
merchantId Yes The merchant-id from Paypal. It needs to be populated in the fast checkout. This value can be found in the merchant account setting N/A
intent Conditional (populate only if you want to use capture) The intent of the PayPal order. Determines whether the funds are captured after the buyer checks out, or if the buyer authorizes the funds to be captured later. Not applicable for subscriptions. authorize (if not populated) authorize/capture
clientId No The client-id from PayPal. It needs to be provided if you have subclients which have their own client-id N/A
currency No Currency of the transaction N/A EUR