The Split Payment feature in WPSubscription allows you to sell any product with a fixed number of scheduled payments. Instead of charging the full price upfront, users can pay in installments over a defined period.

This is particularly useful for high-ticket digital products, services, agency retainers, and project-based billing.

BlockNote image

Key Capabilities

  • Compatible with most WooCommerce-supported gateways (Stripe, PayPal, Paddle, Bank Transfer, etc.)

  • Auto-renews at intervals (e.g., every 1 month or 7 days) until all installments are paid.

  • Subscription expires automatically after completing the final payment.

  • Fully integrated with WPSubscription’s customer dashboard and order lifecycle.

How to Configure a Split Payment Plan

  1. Enable "Subscription" checkbox for your product.

  2. Set Repeat payment every: Choose how often a customer is billed (e.g., every 1 month).

  3. Set Number of Payments: Define the total number of payments to collect (e.g., 3 for 3 monthly payments).

  4. Optionally configure: Other options available for creating subscriptions.

Once the customer completes the final payment, the subscription status changes to Completed, and billing stops automatically.

BlockNote image

Store Managers Experience

Clear visible status in subscription details page.

BlockNote image

Customer Experience

  • Customers can view total and completed payments (e.g., 2/3).

  • Payment method and next billing date are clearly visible.

  • Users can cancel or early renew (if allowed by settings).

  • Subscription ends automatically after all installments are paid.

BlockNote image

Available Action Hooks (Developers)

The following action hooks are available to extend, monitor, or integrate the split payment system:

Hook

Description

Location

subscrpt_split_payment_created

Fires when a new split payment subscription is created

includes/Illuminate/Helper.php → process_new_subscription_order()

subscrpt_split_payment_completed

Fires when the final installment has been paid

includes/functions.php → subscrpt_is_max_payments_reached()

subscrpt_split_payment_renewed

Fires after each successful renewal payment

includes/Illuminate/Helper.php → process_order_renewal()

subscrpt_split_payment_failed

Fires when a renewal payment fails

subscription-pro/includes/Api/SubscriptionAction.php

subscrpt_split_payment_cancelled

Fires when a user cancels a split payment plan

includes/Illuminate/Action.php → cancelled()

subscrpt_split_payment_early_renew_triggered

Fires when early renewal is triggered by the customer

subscription-pro/includes/Illuminate/Helper.php → create_early_renewal_history()

Available Filter Hooks

These filters allow developers to override or adjust default behaviors:

Filter

Purpose

Location

subscrpt_split_payment_args

Modify split payment arguments like price or interval before creation

includes/Illuminate/Helper.php → process_new_subscription_order()

subscrpt_split_payment_total_override

Override the total number of installments programmatically

includes/functions.php → subscrpt_is_max_payments_reached()

subscrpt_split_payment_expire_status

Customize what status is set after the final payment

includes/functions.php → subscrpt_is_max_payments_reached()

subscrpt_split_payment_next_due_date

Alter logic for the next payment due date

includes/Illuminate/Order.php → generate_dates_for_subscription()

subscrpt_split_payment_disable_cancel

Disable the cancel button under certain conditions

includes/Frontend/MyAccount.php → view_subscrpt_content()

subscrpt_split_payment_button_text

Customize button text like "Early Renew"

includes/Frontend/MyAccount.php and subscription-pro/includes/Frontend/Account.php

Developer Use Cases

  • CRM & Marketing Sync: Use hooks to push data into external CRMs.

  • Custom Access Control: Grant or revoke access progressively with each payment.

  • Logic Extensions: Block cancellation after second payment, or offer upsells after third.

  • UI Adjustments: Change button behavior or messaging based on payment state.

  • Reporting/Analytics: Track user progress, churn, and revenue milestones.

The Split Payment system in WPSubscription is now automation-ready and can be easily extended for real-world business workflows.