Recurring Profile and Bundled Item

Recurring Profile and Bundled Item

October 20, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Recurring Profile and Bundled Item

Solving Recurring Profile and Bundled Item Conflicts

As a developer for an e-commerce platform, I often encounter scenarios where merchants want to offer both recurring subscriptions and one-time products in the same transaction. However, certain payment gateways like PayPal Website Payment Pro can throw errors when attempting to process such mixed carts.

Understanding the Conflict

The error message “Nominal item can be purchased standalone only” occurs because PayPal’s system treats virtual items differently from physical ones. When you create a bundled product containing both a recurring profile (virtual) and other one-time products (nominal), PayPal expects them to be processed separately.

In your current setup, the bundled item is likely configured as “Require payment for this item” which triggers this issue when trying to process the transaction.

Resolving the Issue

To allow customers to subscribe to your service while purchasing additional items in a single checkout, you’ll need to handle the payment process manually or use a third-party extension that supports mixed carts with PayPal. Here are two approaches:

1. Manual Payment Process via API

You can create a custom checkout process that splits the transaction into two parts:

  • Part A: Process the recurring profile separately using PayPal’s Recurring Payments API.
  • Part B: Process all one-time products together in a single transaction.

To implement this, you’ll need to:

  1. Redirect the customer to your own “checkout” page after they add items to their cart.
  2. On the checkout page, make an API call to create a new recurring profile for the subscription service (following PayPal’s documentation).
  3. Store the created profile ID and redirect the customer back to the cart.
  4. When the customer proceeds to payment, collect all one-time product details along with the recurring profile ID.
  5. Make another API call to process the one-time items as a single transaction. You can do this by creating an invoice or a standard payment using PayPal’s Express Checkout API.

Remember to handle errors and edge cases appropriately in your code. For example, if the first API call fails, you should not proceed with the second call for the one-time products.

2. Using a Third-Party Extension

If manual payment processing is too complex, consider using extensions like “PayPal Adaptive Payments” or “Mollie Payments” which support mixed carts out of the box. These extensions can handle both recurring profiles and nominal items in the same transaction without requiring API integrations.

To use an extension:

  1. Purchase and install the appropriate extension for your e-commerce platform.
  2. Configure it according to the documentation provided by the extension developer.
  3. Test the integration with PayPal to ensure smooth processing of mixed carts.

Best Practices

Regardless of which approach you choose, here are some best practices to keep in mind:

  1. Separate Recurring and Nominal Items: Logically separate recurring items from nominal items during the checkout process. You can achieve this by creating two distinct line items for your customer’s order—one for the subscription and one for the additional products.
  2. Handle Cancelled Subscriptions: Implement a mechanism to handle cases where customers cancel their subscriptions before paying for the one-time items. You should not finalize the payment for the nominal items until the recurring profile is active.
  3. Test Thoroughly: Ensure you thoroughly test your integration, including edge cases such as order cancellations and failed payments.

Conclusion

Dealing with mixed carts containing both recurring profiles and nominal items can be complex when using certain payment gateways like PayPal Website Payment Pro. However, by either manually processing the transactions via API or leveraging a third-party extension that supports mixed carts, you can provide your customers with a seamless shopping experience.

The key is to understand how each item type (virtual vs. nominal) needs to be processed separately and ensure your platform handles this logically during checkout. Proper handling of edge cases and errors will further enhance the user experience and minimize potential issues in the payment process.

If you’re looking for more guidance on e-commerce development, feel free to explore our resources at Laravel Company. We regularly publish articles on best practices, tips, and tricks for building robust e-commerce applications.

Checkout Catalog API Extensions

Our network