Onboarding guide

Installing and configuring the plugin in WordPress

  1. Upload the provided ZIP archive with the plugin to install it and then activate it

  2. Go to WooCommerce > Settings and open the Payments tab

  3. Enable the “Woocommerce Reepay Integration” payment method and click Set up to configure it.

  4. Fill in the following fields to finish the configuration:

    • Title – the title of the payment method to be shown on the front-end

    • Description – the description of the payment method to be shown on the front-end

    • Test mode – if you check this, the Reepay payment window will connect to your test Reepay account (if you have provided the API keys of it further down) and allow you to make tests with the Reepay test credit cards – https://reference.reepay.com/api/#testing

    • License Key – enter the license key that we have provided to you

    • Test Publishable Key and Test Private Key – the API keys from your test Reepay account (see below for instructions on how to generate API keys in your Reepay account)

    • Live Publishable Key and Live Private Key – the API keys from your live Reepay account (see below for instructions on how to generate API keys in your Reepay account)

    • Webhook secret – the secret key from your Reepay webhook (see below on instructions on how to setup webhook in Reepay)

    • Payment methods – choose All available cards + optionally MobilePay Subscriptions, if you have that enabled in your Reepay account too.

  5. Press “Save changes”

  6. You are now ready to create new products.

Generating API keys in Reepay

  1. Login to your Reepay control panel

  2. Go to Developers > API credentials

  3. Click “Generate new” for both your Public API keys and Private API keys

Configuring Reepay webhook

You need to configure a Reepay webhook, which will allow Reepay to notify our plugin of new recurring payments being made, so that corresponding new orders in WooCommerce are created automatically for each new payment.

In order to do that:

  1. Go to Developers > Webhooks

  2. Press the “Configuration” button in the top right

  3. In the URLs section add the URL of your WordPress website

  4. In the Event types section, make sure that the “subscription_renewal” event is checked (it’s ok if you already have other events checked, our plugin will only process the subscription_renewal one).

  5. Copy the webhook Secret, since you will need to enter it when configuring the plugin in your WooCommerce settings.

  6. Press Save

Shipping costs

Any shipping costs will be added to the created Reepay subscriptions as an add-on. The add-ons are automatically created.

Those shipping add-ons will then automatically be attached to every new payment (and invoice) on the subscription that Reepay does.

Discounts

For discounts to work properly, a discount should be setup in both WooCommerce and Reepay – and in the same way, with same parameters.

In Reepay you can do that from Configuration > Discount settings.

It is important that you make sure the handle ID of the discount you create in Reepay is the same as the coupon code you will create in WooCommerce.

Limitations

  • The plugin cannot be used on products that are with non-standard types – i.e. product types introduced by other plugins (fx. Rental products, Subscription products enabled by WooCommerce Subscriptions, etc.)

    • Please contact us if you have such a case and we will provide an offer for customizing our plugin to be compatible with the plugin(s) you use.

  • The plugin doesn’t support subscriptions with trials – this is in our short term pipeline

  • The plugin doesn’t support subscriptions with setup fee – i.e. subscription can be purchased, but setup fee is not displayed in WooCommerce checkout.

Setting up products

Our plugin can be used for:

  • Subscription product – new type of product enabled by our plugin

  • Variable product – the out of the box type of product coming with WooCommerce


For the “Subscription product” in the general settings you can pick a plan that the product corresponds to, whether or not to show a start date picker to your customers or as an alternative to set a fixed start date for this product.

For “Variable product” you can generate your variations and then pick a specific plan for each variation. Be sure to set the price of the variation, since WooCommerce requires that. Finally all variations of the product will use the start date setting that you set in the general settings of the Variable product.