Skip to content
English
Go to kafene.com
  • There are no suggestions because the search field is empty.

WooCommerce Plugin

This guide walks you through installing and configuring the Kafene WooCommerce plugin, understanding order workflows, and going live with lease-to-own payments on your store.

Configure the Kafene Plugin

To configure your plugin you will need to complete configuration in WooCommerce and Kafene's merchant portal.

Step 1. Install the Kafene plugin on your WooCommerce site. 

Step 2. Go to WooCommerce > Payments, locate Kafene, and select Manage. 

Step 3. Login to Kafene's merchant portal and go to app configuration and add a new configuration. 

Step 4. Select your store, copy and paste the API key, store ID and merchant ID and update WooCommerce. 

Step 5. In Kafene's merchant portal go to the next step. Copy and paste the webhook from WooCommerce and add this to Kafene. 

Step 6. Save your details 

Field

Details

Enable / Disable

Toggle ON only after all credentials below are configured.

Environment

Use Staging (https://staging-partner-api.kafene.com) for testing. Switch to Production (https://partner-api.kafene.com) when going live. Do not fulfill staging orders.

Merchant ID

You will be able to locate your merchant ID in Kafene's merchant portal. Format: MER-XXXXX 

Store ID

You will be able to locate your store ID in Kafene's merchant portal. Format: STR-XXXXX 

API Key

You will be able to locate your API key in Kafene's merchant portal. Unique per environment — make sure you use the correct key for Staging vs. Production. 

Webhook URL

You will need this webhook to complete setup in Kafene's merchant portal. https://yourdomain.com/wc-api/WC_Payment_Gateway_Kafene

Product Configuration

After installing the plugin, you will need to update your products and flag which items are eligible for leasing. Only items marked as leasable will appear with the Kafene payment option. Your account manager will provide a list of items that cannot be leased.

To update a single item:

    • Open the product, check the box labeled Leasable with Kafene, and save.

To update multiple items at once:

    • Select the items in the product list, open Bulk Actions, and choose Set as Kafene Leasable or Remove as Kafene Leasable.

Once your items have been updated double check your plugin, make sure you have everything configured correct and enable the plugin. Once enabled Kafene should be available at checkout!

Tax Configuration

Orders processed through Kafene are automatically categorized as tax exempt. Resale certificates are available in your Kafene merchant portal.

Order Statuses

Status

What it means

Pending Payment

The customer is completing their Kafene application. If denied, the order stays in this status until a different payment method is chosen.

Processing

Lease agreement is signed and the order is ready to fulfill.

Completed

Items have been received by the customer. The order is now eligible for funding.

Cancellations & Adjustments

Cancellations and adjustments made in WooCommerce do not automatically update the Kafene lease. You must cancel or adjust the lease directly in your Kafene merchant portal.

For leases that are in a Processing or Completed state, contact Kafene support to make adjustments:

Finding Orders in the Kafene Merchant Portal

Once a customer signs their lease agreement, you can look up their order in the Kafene merchant portal:

  • Go to the order in WooCommerce. The Kafene Application ID is displayed beneath the order number.

  • In the Kafene merchant portal, search for the customer using that Application ID.