Skip to main content

Inline Checkout


Inline Checkout is an iframe checkout option which displays a secure payment form as an overlay on your checkout page. Use Inline Checkout to:

  • Benefit from a cart template designed to increase your conversion rates.
  • Provide a seamless shopping experience to your customers, with a payment that occurs on your website.

Inline Checkout integrates ideally with shopping cart applications that collect customer billing and shipping information, allowing you to pass that information over to the cart, and minimize customer's efforts during the payment process.

inline checkout.jpg


Inline Checkout is available for accounts that have ConvertPlus enabled on their account. Contact 2Checkout for activation.


As Inline Checkout and ConvertPlus use the same back-end engine, the current functionalities and limitations of ConvertPlus apply to Inline Checkout.

Read here the capabilities of ConvertPlus and Inline Checkout.

How to integrate Inline Checkout

To integrate Inline Checkout with you shopping cart, follow the steps below:

  1. Go to Setup > Generate links area.
  2. Click the Inline Checkout tab.
  3. Copy the JavaScript code generated by our platform and paste it in your shopping cart application JavaScript code. 

Collect payments with Inline Checkout

After you integrate the Inline Checkout JavaScript code in your backend application, you get access to the library that allows you to add products, control billing and shipping details and start the checkout process. 

To collect payments with Inline Checkout, you need to:

  1. Send your Merchant Code
  2. Add products to cart
  3. Start the Checkout process

Sending the merchant code

When loading the cart application, send the checkout mode and your merchant code. Use the following setter methods to send this information:

  •  setMerchant (required) - for the merchant code. Your merchant code can be found in your Control Panel, in the Account Settings page.
  •  setMode (optional) - based on the product type. The default product mode is CATALOG. Use DYNAMIC only for orders placed with dynamic product information.

add products to cart

After sending your merchant code, use the add method to pass the product information to Inline Checkout. Use the code parameter as the product identified, and quantity to determine how many products are included in cart.

Start the checkout 

After adding products in cart, start the Inline Checkout experience by using the checkout method. Starting the checkout method will display the payment overlay on your website.

Sample request

The below request represents a basic use of Inline Checkout, that allows your users to finalize purchases directly from your website via a secure payment form.

TwoCoInlineCart.setup.setMerchant('merchantCode'); // your Merchant code

    code: 'the-2co-product-code',
    quantity: 3
}); // add products to cart

TwoCoInlineCart.cart.checkout(); // start checkout process

Advanced Inline Checkout experience

Inline Checkout offers you advanced control over the ordering process, for minimizing the customer's effort during the purchase. You can send the billing and delivery information directly to the cart, if they are collected on your website by a shopping cart application. Inline Checkout also allows you to:

  • Place test orders
  • Set coupons codes in cart
  • Set the cart language
  • Set the cart currency
  • Set a redirect URL after a finalized purchase

Read our article for Advanced Inline Checkout experience to gain full control over the Inline Checkout process.

Inline Checkout for 2Checkout upgraded merchants

Note to user NOTE:  The below section only applies to merchants upgraded from 2Checkout 1.0 platform.

Merchants that already use Inline Checkout only have to update the JavaScript library from the previous platform with the new one available in the Control Panel, Generate Links area. The parameters from 2Checkout's previous Inline Checkout version continue to work in the new platform.