This feature enables automatic recurring billing for subscription products, requiring no manual intervention once initiated
Merchants & Admins Guide
- Enabling Subscriptions: Navigate to WooCommerce → Settings → Payments → UPayments and toggle on "Enable Subscriptions". Ensure this feature is also activated on your main UPayments merchant dashboard.
- Product Setup: Products must be assigned the "Subscription Product" type and tagged with "subscription".
- Customer Eligibility: To purchase, customers must be logged into their account and have a valid Mobile Number in their profile.
- Checkout Constraints: No Mixed Carts: Subscription products cannot be in the cart with standard products simultaneously.
- Payment Restrictions: Auto-deduction strictly requires Credit Cards for tokenization; therefore, KNET, Apple Pay, and other methods are automatically hidden during a subscription checkout, and another restriction is that subscription orders cannot be done through the WooCommerce backend since the customers must be logged into their account and do the payment, and the card is saved for the recurring payments later.
- Backend Orders Restrictions: Subscription orders cannot be created manually via the WooCommerce backend. To ensure successful recurring payments, customers must log into their accounts and complete the checkout process themselves so their card details can be securely saved.
- Management: Customers can Cancel, Pause, or Resume subscriptions from their "My Account" page.
Developer Guide (Architecture & Security)
- High-Level Flow: The initial checkout creates a base order and an external subscription record. A CRON job triggers auto-deduction on renewal dates, creating a new renewal order in WooCommerce automatically.
- Tokenization Mandate: UPayments generates a unique customer token and credit card token during the first checkout.
- Security Standard: To ensure strict compliance, tokens are attached only to the order context and are NEVER stored in the local WooCommerce database or the UPayments database.
Troubleshooting FAQ
Why is the subscription option missing at checkout?
Verify that subscriptions are enabled in settings, the product is the correct data type, and the customer is logged in.
Why is KNET/Apple Pay hidden?
Subscriptions force Credit Card validation to enable auto-deduction; incompatible methods are hidden by design.
What if a renewal fails?
This is typically due to an expired card or revoked mandate. Check gateway logs and webhook history for details.