Requirements

• WordPress 6.2 or higher
• WooCommerce 8.0 or higher
• PHP 7.4 or higher
• A Recurly account and private API key (Recurly Admin → Integrations → API Credentials)

Install and license

1. Buy Recurly Integration on munjr.com. After checkout you receive a Munjr license key (munjr.com bills plugin licenses through Chargebee; the key is that Chargebee subscription ID).
2. Install the plugin zip on the WordPress site where you sell subscriptions.
3. Go to Settings → Munjr License.
4. Paste the key into Munjr license key and click Activate license. One site per subscription.

When we publish a new plugin version, the zip on your munjr.com order download is replaced. See the changelog.

Setup and configuration

Open WooCommerce → Settings → Recurly.

Recurly API

1. Enter your Recurly private API key.
2. Set Region to US or EU to match your Recurly data center.
3. Click Verify Connection. The plugin validates the key and fetches the public key used by Recurly.js. A site-mode badge (Production, Sandbox, or Development) appears after a successful verify — there is no separate sandbox toggle; the API key determines the Recurly site.
4. Click Save changes.
5. Enable the Recurly gateway under WooCommerce → Settings → Payments. It only appears at checkout when the cart contains Recurly subscription products.

Currency

Plans and checkout use only currencies supported by both WooCommerce and Recurly. Click Reload currencies after you verify the connection. If your store currency is not in the viable set, subscription checkout is blocked until you align currencies.

Create a subscription product

1. Create or edit a WooCommerce product.
2. Set Product type to Recurly Subscription (also offered on WooCommerce → Home → Add products).
3. Open the Subscription Plan Config tab.
4. Configure the fields below. Keep the product in Draft until Recurly creates the plan, then publish.

Field	What it does
Subscription term length	Number of billing periods (for example 12). Sent to Recurly as total billing cycles.
Subscription price	Recurring price per period in the store currency.
Billing period	Monthly, every 3 months, every 6 months, yearly, or a custom interval in days or months.
Accounting code	Optional. Max 20 characters: letters, numbers, underscore, plus, hyphen.
Add a trial period?	Optional trial length and unit. Trial requires billing info controls whether Recurly.js collects a card for a $0 trial.
Auto renew	If on, Recurly renews at term end. If off, the subscription expires at the end of the term.
Tax exempt?	Whether Recurly applies tax on the plan.

On save, the plugin creates a Recurly plan with code wc-{product_id} and description Created via WooCommerce Recurly Integration – Product #{id}.

If plan creation fails, the product stays in Draft. Fix the settings and click Retry plan creation or Publish again.

Trials

When a trial is enabled, the cart and order show a $0.00 line with a trial label, and shop/product pages show a Free X days|months trial badge. Recurly still creates the subscription using the plan and trial you configured. WooCommerce Blocks product grids may not show the badge.

Checkout

1. Add a Recurly Subscription product to the cart.
2. On checkout, select Credit Card (Recurly).
3. Enter card details in the Recurly.js Elements fields and place the order.

The card is tokenized in the browser and never touches your WordPress server. WordPress creates or reuses a Recurly account and creates the subscription.

Logged-in customers always use Recurly account wc-user-{user_id}. Guests are looked up by billing email: if exactly one Recurly account matches, that account is reused; otherwise a new account wc-guest-{order_id} is created. Billing address from the order is sent to Recurly.

My Account

Logged-in customers get My Account → Manage Subscriptions (/my-account/recurly-subscriptions/). They can list subscriptions for account wc-user-{id}, cancel at period end, or reactivate. Immediate termination is not available in WooCommerce.

If that URL returns 404, open Settings → Permalinks and click Save once.

How billing works

Recurly is the source of truth after the first purchase. This plugin creates the subscription at checkout. Renewals, invoices, dunning, payment retries, immediate termination, account closure, and refunds are managed in Recurly Admin, not in WooCommerce.

Limitations

• WooCommerce coupons cannot be used when the cart contains Recurly subscription products.
• Mixed carts (subscription + one-time products) are blocked.
• Variable / matrix products are not supported.
• Ramp pricing is not supported (fixed price per period only).

FAQ and troubleshooting

Verify Connection fails

Use a private API key from Recurly Admin → Integrations → API Credentials, and match the Region (US/EU) to that Recurly site.

No Recurly card fields on checkout

The cart must contain a Recurly Subscription product, the Recurly gateway must be enabled, and the connection must be verified (so the public key exists). Mixed carts hide the gateway.

Plan creation failed

Open the product, read the error on Subscription Plan Config, confirm the store currency is viable, then Retry plan creation.

License will not activate

Use the Munjr license key from your munjr.com order — not a Recurly API key. Each subscription licenses one WordPress site.

Changelog

Newest version first. When we ship an update, the zip attached to your munjr.com order download is replaced.

0.1.0

• Initial public release: Recurly.js Elements checkout, automatic plan creation, munjr.com licensing, and My Account subscription management.

Support

Questions about Recurly Integration, licensing, or an existing munjr.com subscription: Contact us. We typically respond within two business days. You can also follow all plugin docs.