Woocommerce Paypal

  1. Woocommerce Paypal Api
  2. Woocommerce Paypal Ipn
  3. Woocommerce Paypal Setup
  4. Woocommerce Paypal Pro

There are two modules for WooCommerce that support Pay Later: WooCommerce PayPal Payments and PayPal Checkout. When you enable one of these modules and connect a PayPal account, Pay Later messaging is enabled by default. Note Ensure that PayPal Payments is at least on version 1.0. (Version 1.1.0 is recommended.). PayPal Checkout is now available for your WooCommerce store. It's a way for you to offer more payment options for your customers to choose from, including Venmo and PayPal Credit. You can continue to accept traditional payment methods, such as PayPal and major credit and debit cards. Overview Braintree for WooCommerce (formerly PayPal Powered by Braintree) lets you accept credit cards and PayPal payments on your WooCommerce store via Braintree. Customers can save their credit card details or link a PayPal account to their WooCommerce user account for fast and easy checkout.

WooCommerce Subscriptions comes with built-in support for two different PayPal payment methods:

  • PayPal Standard
  • PayPal Reference Transactions via Express Checkout

By default Subscriptions uses the first of these – PayPal Standard. This is the easiest to configure. You can sell subscription products with PayPal Standard straight away with a PayPal business account. You do not need any further setup to start receiving recurring payments from your customers with PayPal Standard.

If you need to be use any of the advanced features of Subscriptions with PayPal, including upgrades/downgrades or need to workaround some of PayPal Standard’s limitations, then you will need to apply with PayPal for Reference Transactions. These are required both when using PayPal built-in to Subscriptions, and the PayPal Checkout extension with Subscriptions.

Reference Transactions is not a standard product and approval is subject to a fully underwritten application. This can include reviewing your business model and finances to determine your suitability.

This FAQ answers common questions about getting your PayPal account approved for Reference Transactions, and how PayPal Reference Transactions work with WooCommerce Subscriptions.

How do I get Reference Transactions Enabled with PayPal? ↑ Back to top

To request that PayPal turn on Reference Transactions, call your local PayPal Support Help Center. Find the phone number at Contact.

Tell PayPal that you are specifically calling so a PayPal Specialist can enable Reference Transactions on your account. They may try to help you set up recurring payments with a button — that is not want you want. They need to transfer you to a specialist who will ask you for your PayPal account information (email address), and then tell you that they filed a ticket, and you will hear back from PayPal via email on whether Reference Transactions have been enabled or not.

Email Application ↑ Back to top

You can also contact PayPal via email.

  1. Log into your PayPal account.
  2. Go to the Email Contact Form.
  3. Choose topic: Business solutions.
  4. Choose sub-topic: PayPal payment solutions.
  5. Choose sub-topic: PayPal Express Checkout.
  6. Copy and paste the message below, inserting your PayPal email address and name.
  7. Wait for a reply.

Example Message to send to PayPal ↑ Back to top

Gotcha: Respond to the Autoresponder ↑ Back to top

In an effort to reduce support, PayPal may send you a response from an auto-response message with some links to documentation.

Hidden in this auto-response is the following:

If we haven’t answered your question, please reply to this email and our team will answer you as soon as possible.

You also need to respond to the auto-response before your support ticket is submitted to PayPal.

Will My Account Qualify for Reference Transactions? ↑ Back to top

PayPal does have a set a requirements that need to be met before they enable support for Reference Transactions on your account.

Unfortunately, PayPal does not publish these requirements and based on anecdotes from customers, the requirements can be different for different businesses.

Some things that store owners have mentioned PayPal require are:

  • High personal credit (FICO) score for US based PayPal Business accounts
  • Business plan
  • Average transaction price
  • Number of repeat customers
  • Number of Reference Transactions per customer
  • Revenue forecast and/or projected total revenue volume from Reference Transactions
  • Demonstrate a clear business rationale behind the request
  • Show the signup flow for customers in regards to Reference Transactions.
  • Proof that you will show clear terms and conditions for customers in regards to Reference Transactions and how to cancel once they sign up.
  • Written statement as to why you need Reference Transactions and how you will use it for your business.

In terms of revenue forecasts, we have had reports that UK based PayPal accounts may require minimum forecast of £6,000 month or more revenue.

How do I Enable Reference Transactions in Subscriptions? ↑ Back to top

WooCommerce Subscriptions takes advantage of Reference Transactions when possible.

If your PayPal account does not have Reference Transactions enabled, Subscriptions automatically checks with PayPal once a week when loading the WooCommerce > Settings > Payments screen to see if support has since been enabled.

If you wish to run the check manually:

  1. Go to WooCommerce > Settings > Payments > PayPal.
  2. Ensure PayPal is enabled and your credentials are set.
  3. Select Check PayPal Account when the Reference Transaction notice appears.

Will Existing Subscriptions use Reference Transactions? ↑ Back to top

No. Any existing subscriptions continue to be PayPal Standard subscriptions.

PayPal Reference Transactions are only used for future subscriptions. This means that advanced subscription management features, such as recurring amount changes, are only possible on newly purchased subscriptions, not existing ones.

However, enabling Reference Transactions makes it possible to upgrade or downgrade existing subscriptions.

The only way to have existing PayPal Standard subscriptions changed to use PayPal Reference Transactions is to have customers sign-up again with PayPal by changing the payment method on their subscription(s).

Why are billing agreements not cancelled at PayPal when a subscription is cancelled in WooCommerce? ↑ Back to top

When a PayPal Standard Subscription is canceled or suspended in your WooCommerce store, status of the corresponding subscription at PayPal is also changed.

However, when a subscription created using PayPal Reference Transactions is canceled or suspended in your WooCommerce store, the corresponding Billing Agreement at PayPal does not have its status changed. It remains active.

Woocommerce Paypal

This is normal behavior because Billing Agreements are fundamentally different to PayPal Standard subscriptions.

A PayPal Standard Subscription needs to be suspended or canceled because future payments would be processed on that subscription if it were to remain active. For a Billing Agreement, this is not the case. Once a subscription purchased using Reference Transactions has been canceled in your WooCommerce store, no future payments are processed against that billing agreement because Subscriptions no longer requests any payments.

The Billing Agreement is left active at PayPal because:

  • Billing Agreements are per store not per subscription. Meaning if your customer has purchased multiple different subscriptions with your store, the same Billing Agreement ID is shared between all of those subscriptions. If it were to be canceled when one subscription is canceled, all other subscriptions would be unable to continue.
  • Billing Agreements can be manually added to a manually created subscription or even used to undo cancellation of a canceled subscription (impossible to do with PayPal Standard Subscriptions), but only if the billing agreement remains active in PayPal.

For these reasons, it is recommended that you do not cancel Billing Agreements manually at PayPal. If your customer chooses to cancel their Billing Agreement at PayPal, Subscriptions handles that and cancels all subscriptions in your store using that Billing Agreement. But to give you maximum flexibility in working with customers, it is recommended you do not cancel the Billing Agreement.

Why has the initial payment changed in Subscriptions v2.0.10? ↑ Back to top

PayPal provide two options for charging an initial payment when creating a billing agreement with reference transactions:

  • Charge the initial payment alongside the request to create the billing agreement.
  • Charge the initial payment against the billing agreement after it has been created in a separate request.

There is little difference in terms of when the customer pays or the store receives the payment between these options. Both result in a payment almost immediately. However, there are many differences in terms of how PayPal presents and stores details of the payment.

Prior to WooCommerce Subscriptions version 2.0.10, the second of these methods was used. This meant, regardless of whether the initial order was for $0 or more, no initial payment was charged alongside transaction details the customer agrees to at PayPal. This method has the following downsides:

  • No details about the initial payment are displayed to the customer when agreeing to the transaction at PayPal. Instead a billing agreement description would be displayed, and PayPal only allow one 127-character string to be used to describe the billing agreement (this description is also used on all future payments against that agreement, including for new subscription purchases and recurring payments, so it needs to be generic to avoid confusion).
  • No line item details — individual product, tax and shipping costs — about initial payment are included in emails sent from PayPal to the customer and store owner, only total of payment.
  • No line item details for recurring payments are included in the PayPal side of the transaction, so they are not displayed in the PayPal interface or emails sent to the customer or store owners.

A number of store owners complained about this behavior. As a result, Subscriptions version 2.0.10 switched to the alternative method of charging an initial payment in the same request that creates the billing agreement. This helps ensure that line items are displayed to the customer when agreeing to the transaction at PayPal and alongside the transaction at PayPal.

But this method also has a downside: PayPal appears to treat this initial payment as a separate transaction to the billing agreement, even though they are processed in the same transaction. So the amount charged for any initial payment is no longer included in the recurring total for a billing agreement in the PayPal dashboard.

PayPal does not provide a way to ensure that both the initial payment information is presented to the customer on checkout and that initial payment on subscriptions products is accounted for in the total amount charged for a billing agreement/recurring amount at PayPal. There is no way to get the best of both options.

Because better information is provided to the customer on PayPal Checkout with the new method, this was chosen as the best method to use in WooCommerce Subscriptions.

Screenshots of Differences ↑ Back to top

Screenshots help demonstrate the differences between the two methods.

Is Guest Checkout Possible with PayPal Reference Transactions? ↑ Back to top

No, PayPal provides no way for customers to check out without a PayPal account when using PayPal Reference Transactions.

If you wish to allow your customers to check out without a PayPal account, there are many other payment gateways that support automatic recurring payments. Stripe or Braintree are good options.

PayPal does provide a premium feature to U.S. based companies to offer Guest Checkout with PayPal Standard; but this is not available for transactions that use PayPal Reference Transactions.

PayPal Express Checkout, the PayPal product that Subscriptions uses to process Reference Transactions, also offers a guest checkout option that can be set in the API request or your PayPal account. However, this option is not supported for Reference Transactions. PayPal explained this via support request; it is not published publicly in the Express Checkout documentation.

Are Payment Authorizations Supported when using PayPal Reference Transactions with Subscriptions? ↑ Back to top

No. WooCommerce Subscriptions always captures payment immediately for subscription transactions. That includes both the initial and recurring payments. If you would like authorization then capture to be supported in a future version, please submit it as a feature request on the Ideas board.

Do Reference Transactions use PayPal Standard or Express Checkout? ↑ Back to top

Reference Transactions use the PayPal Express Checkout product. The full name for the product is PayPal Reference Transactions via Express Checkout.

To simplify setup of Reference Transactions with WooCommerce Subscriptions, once Reference Transactions are enabled by PayPal on your PayPal account, Subscriptions will use the PayPal account details already entered on the WooCommerce > Settings > Checkout > PayPal administration screen. This avoids having to duplicate the same PayPal account settings, like API credentials, on an additional administration screen.

As the details on that PayPal settings screen are used for PayPal Standard purchases in WooCommerce core, and PayPal Standard Subscriptions prior to Reference Transactions being enabled, this can lead to confusion about which PayPal product Reference Transactions uses. Because of this, it will be changed in a future version of Subscriptions.

WooCommerce Subscriptions is a premium extension that offers two methods for accepting recurring payments:

  • Automatic payments
  • Manual payments

To understand the difference between the two methods, read Subscription Renewal Process before continuing.

This guide provides a detailed and up-to-date list of the gateway extensions that support one or both payment methods. For extensions that support automatic payments, it also provides information about supported subscription-specific features.

Extensions for Automatic Payments ↑ Back to top

The following payment gateway extensions support automatic recurring payments and are part of the official WooCommerce marketplace. This means they are backed by WooCommerce.com support and customer service.

Different payment gateways offer different features. The tables outline which Subscriptions features are supported by each WooCommerce payment gateway, with an explanation of each feature found below the table.

Basic Features ↑ Back to top

Advanced Features ↑ Back to top

Woocommerce Paypal Api

Notes on Extension Support

This guide is based on the official WooCommerce extension for each payment gateway. It does not mean automatic payments are supported when:

  • Using an extension purchased or downloaded from a vendor other than WooCommerce.com.
  • Accessing one of these gateways through a third-party hosted checkout system.
  • Integrating a gateway with another unless that payment gateway is also mentioned above. For example, customers can purchase subscriptions and have future automatic recurring payments processed with PayPal via the Braintree for WooCommerce extension, which is why there is a row in the table above for Braintree (PayPal). However, other payment gateways that also offer PayPal payments cannot be used to create subscriptions with automatic payments via PayPal.

The table also refers to the latest version of the payment gateway extension. If you have an outdated version installed, automatic payments may not be enabled. You can check the latest version by viewing the changelog for each extension. To view the changelog:

Woocommerce Paypal Ipn

  1. Click the name of the extension in the table. This takes you to the product page at WooCommerce.com.
  2. Find Changelog on the page.
  3. Click the link, and compare your version to the current one.

Explanation of Features

Subscription Suspension, Cancellation or Reactivation: A store manager or customer can change the status of a subscription directly from your store, i.e., without visiting the payment gateway.

Woocommerce Paypal Setup

Multiple Subscriptions: A customer can add different subscription products to their cart and complete checkout. More info at: Guide to Multiple Subscriptions.

Recurring Total Changes: You as store manager can manually change the recurring amount charged for renewal payments.

Woocommerce Paypal Pro

Payment Date Changes: You as store manager can manually change the payment schedule for a subscription, including the expiration date, trial length or next payment date.

Customer Payment Method Changes: Payment gateway is presented as an option when a customer changes the recurring payment method used for a subscription. It also means Subscriptions can update the payment method used for future recurring payments when a customer pays for a failed renewal.

Store Manager Payment Method Changes: Payment gateway is presented to the store manager as an option when changing the recurring payment method used for a subscription on the Edit Subscription screen.

PayPal Standard Limitations

Although PayPal Standard is included free with Subscriptions, it is also one of the most limited payment gateways. The document on the Limitations of PayPal Standard contains the many limitations of PayPal Standard as well as how to move away from using it.

Extensions for Manual Payments ↑ Back to top

All WooCommerce payment methods and gateway extensions can be used to process manual subscription payments. Subscriptions creates a pending order for the renewal, then that order can be paid with any gateway with a working WooCommerce extension.

When using a manual payment for a subscription, all features included in the table above are supported. Meaning the subscription can be suspended, canceled and reactivated. It can also have its recurring amount, next payment date and billing schedule changed.

The renewal method applied to a subscription at the time of purchase is always applied to the subscription. So if the payment method used to purchase a subscription could only process manual renewal payments at time of purchase, the subscription continues with manual renewal payments even if the payment gateway extension adds support for automatic recurring payments.

Third-Party Extensions with Automatic Payment Support ↑ Back to top

The following payment gateway extensions support automatic subscription payments and are developed by third-party developers. Because they are not sold or supported by WooCommerce.com, you need to contact the extension authors with questions.

Want a different payment gateway? ↑ Back to top

If there is another gateway you want to use to sell subscriptions and charge automatic payments, contact the developer of the WooCommerce extension for that gateway to request they add support for WooCommerce Subscriptions.

If you are a developer and want to add support for automatic subscription payments to your gateway, see the Subscriptions Payment Gateway Integration Guide.