Let’s walk through your issue step by step—this is a common setup pain point, so I’ll break down what’s likely going wrong and how to fix it.

Core Problem: Automatic Renewals Not Triggering #

The root issue here almost always boils down to missing configuration for tokenized/vaulted payments or unenabled permissions in Braintree. Let’s start with your specific questions, then dive into actionable fixes.

Question 1: Do I need to create subscription plans in Braintree first, or can I just use WooCommerce Subscriptions with Braintree as the gateway? #

You don’t need to create plans in the Braintree dashboard—WooCommerce Subscriptions handles all the subscription logic (cycles, pricing, renewal schedules) directly. Braintree only acts as the payment processor.

That said, your setup is missing a critical piece: Braintree needs to be configured to store customer payment methods (vaulting) and have permission to initiate automatic charges without re-authorization. If these aren’t set up, the gateway can’t process renewals automatically.

Question 2: Do I need to set up reference transactions for subscriptions? #

Yes, you do. Reference Transactions (sometimes called "vaulted billing" or "recurring payment permissions") are required for Braintree to automatically charge saved payment methods for renewals. This feature lets you use a stored payment token to initiate charges on future dates, without the customer having to re-enter their details each time.

Question 3: Is enabling reference transactions mandatory for automatic renewals? #

Absolutely. Without reference transactions enabled, Braintree can only process one-time payments. Renewals would require either manual intervention from you or the customer to re-authorize the payment. This is a restriction from Braintree’s end, not the WooCommerce plugin.

Step-by-Step Fixes to Enable Automatic Renewals #

1. Enable Reference Transactions in Braintree #

First, you need to request this permission from Braintree:

• Log into your Braintree Merchant Dashboard
• Navigate to Settings > Processing > Payment Methods
• Look for "Reference Transactions"—if it’s not enabled, contact Braintree support to request access (note: this may require meeting certain eligibility criteria based on your business type)

2. Configure the PayPal Powered by Braintree Plugin in WooCommerce #

Once reference transactions are enabled in Braintree, update your plugin settings:

• Go to WooCommerce > Settings > Payments > PayPal Powered by Braintree
• Ensure the following options are checked:
  • Vault Payments (stores customer payment methods for future charges)
  • Subscription Support (integrates with WooCommerce Subscriptions)
  • Automatic Renewals (lets the gateway trigger charges on renewal dates)
• Save your settings and clear any caching plugins you’re using.

3. Verify WooCommerce Subscriptions Settings #

Double-check your subscription configuration:

• Go to WooCommerce > Settings > Subscriptions
• Under "Payment Method Renewals", select Automatically process renewal payments
• Ensure your subscription plans are set to use "PayPal Powered by Braintree" as the payment method
• Confirm the renewal schedule (interval, period) is correctly set for each plan

4. Validate Payment Token Storage #

For existing subscriptions, check if the customer’s payment method was vaulted:

• Go to WooCommerce > Subscriptions and open a customer’s subscription
• Look for the "Payment Method" section—you should see a note like "Vaulted Payment Method" with a token ID
• If no token is stored, have the customer re-update their payment method via their account page (My Account > Subscriptions > Update Payment Method)

5. Test with Braintree Sandbox #

To avoid real charges during testing:

• Switch the Braintree plugin to Sandbox mode
• Use Braintree’s test payment methods (e.g., a test credit card like 4111 1111 1111 1111) to create a test subscription
• Wait for the renewal date (or manually trigger a renewal via the subscription actions)
• Check the Braintree Sandbox dashboard and WooCommerce logs (WooCommerce > Status > Logs > Filter by "subscriptions") to confirm the automatic charge was processed

6. Check Cron Jobs #

WooCommerce Subscriptions relies on WordPress cron to trigger renewals. Ensure your server’s cron is running:

• Go to WooCommerce > Status > Tools > Cron Scheduler
• Verify that events like woocommerce_scheduled_subscription_payment are present and scheduled correctly
• If cron isn’t working, ask your hosting provider to help set up a server-level cron job

Final Notes #

If you’ve followed all these steps and renewals still aren’t triggering, check Braintree’s transaction logs for error messages (e.g., expired card, insufficient funds, or permission issues). These logs will often point to the exact problem.

内容的提问来源于stack exchange，提问作者Kirit Modi