Partial.ly
Back to home

WooCommerce Integration — Complete Setup Guide

WooCommerce Plugin

The Partially WooCommerce plugin allows you to offer Partially payment plans on your WooCommerce checkout page. The order creation is handled by your WooCommerce shop, and payments are processed within Partially.

You can download our WooCommerce plugin here, or from within your WordPress Admin:

  • Go to Plugins → Add New.
  • Search for "Partially. -"Click Install Now on the Partially plugin.
  • Click Activate.

After installing, locate it within your wp-admin under WooCommerce > Settings > Payments > Partially Payment Plans.

Add your API key to the plugin

This allows the plugin to communicate with Partially. You can locate your API Key within your Partially account under Settings > General.

Place your Partially API Key in the plugin under WooCommerce > Settings > Payments > Partially > Manage > API Key.

Enable Partially and select your offer

Once you add your API Key, select "Enable Partially payment method at checkout". Then select the offer you wish to use, along with the order status you'd like applied (see Woo Order Status below).

Do I connect Partially to individual products?

No — Partially is not enabled per product. Once you add your API key, enable the Partially payment method, and select an offer (above), Partially automatically appears as a payment option at your WooCommerce checkout for the whole store. There is no per-product setting in the WooCommerce product editor to "connect" a product to Partially, so you won't find one when editing a product.

If you want to control Partially per product — for example, use a different offer for certain products, or show or hide Partially only for some products — use Smart Customization rules in your Partially account:

  • A Product offer lookup rule maps specific products or variants directly to the offer they should use.
  • Condition rules can match on Product ID, SKU, Tags, or Categories to choose an offer or hide Partially.

Sync your WooCommerce product catalog first (from your WooCommerce settings page) so rules can match your products by SKU, tag, or category. See Smart Customization for WooCommerce for the full details.

Plugin options

  • Enable test mode: check this to use our test server at demo.Partially to test the service before making live charges. You'll need a separate account at demo.partial.ly and the API key from that demo account.
  • Title: once the gateway is enabled, this is the title displayed to customers at checkout.
  • Description: an additional description shown to the customer at checkout when Partially is selected.
  • Partially gateway order status: when a customer checks out with the Partially payment method, orders will be set to this status after the payment plan is opened.
  • Partially offer: once you add the API Key to the plugin, a dropdown list of your offers will appear. Select the offer you wish to use.
  • Send product images to Partially: check this to send product images to Partially.

Widget options

You can enable the Partially widget to appear on your product pages from within the plugin under Widget Options > Enable. The widget lets customers interactively see how Partially would be applied to their purchase.

Save your plugin settings

Once you save your plugin settings, Partially will appear as a checkout option on your website. When the customer places their order with Partially, it will create a corresponding Woo order.

Woo order status

Partially can mark Woo orders with whatever status you would like. Navigate to WooCommerce > Settings > Payments > Partially > Manage and locate "Partially gateway order status." Select the status you would like from the dropdown menu.

"Pending payment" is the appropriate order status for the plan, as not all payments have been collected. See WooCommerce's documentation on order statuses.

Partially will send you email notifications for each plan event (e.g., payment processed, plan paid in full). When notified that a plan is paid in full, you can manually update the Woo order to your required status.

Depending on what you want to do with the order status update, our Webhooks system or our integration with Zapier or n8n might be able to help as well.

Beware of "Hold Stock" feature

If you have the "Hold Stock" feature activated within your WooCommerce Inventory Management, you may experience canceled Woo orders when they are opened by Partially.

If you select the order status "pending" in the plugin, the "Hold Stock" setting will cancel the order.

We recommend you either:

A. Use another order status, such as "Processing." You can update the order status within your plugin.

B. Disable the "Hold Stock" feature by deleting the value (e.g., it typically says 60 minutes) and saving the change so it appears blank.

You can locate/disable this feature within your WooCommerce admin under WooCommerce > Settings > Products > Inventory.

Shipping

When Partially is placed directly on the WooCommerce checkout page, shipping is controlled within your WooCommerce admin.

Customizations

There are a variety of ways to customize the functionality of your WooCommerce integration via Partially's smart customzation rules or utilizing wordpress hooks with custom scripts being added to your theme's functions.php file.