Overview

In this guide you will learn how to integrate Katpault with OpenCart to provide a no credit, lease-to-own payment option for your customers.

Before beginning your integration, please review the following:

  • Online Checkout Flow
  • Your current checkout process to understand how Katapult will impact operations and customers.
  • Leasable Items
  • Deployment Checklist
  • Tax Exemption Management: Katapult is a wholesale merchant and is responsible for collecting sales tax from customers. In some cases this will require additional development. Please review internally and determine the best way to reconcile orders.
  • Confirm all your products have SKUs, item descriptions & item value being passed. It is your responsibility to make sure all items are passed to Katapult with the correct dollar value.

Once your merchant agreement has been completed, you will receive an email with your sandbox login credentials and tokens. If you have not received your tokens, please reach out to [email protected].

Installation

Katapult supports OpenCart version 3.x
Step 1. Download the Katapult OpenCart extension from OpenCart marketplace
Step 2. Log in to your OpenCart admin portal.
Step 3. After login to your portal, go to Extensions > Installer
Step 4. Select the ‘Upload Plugin’ button and choose the 3.x.katapult.ocmod.zip extension file downloaded from the marketplace. It is important that you do not rename this file, this will cause the upload to fail.
Step 5. You should now see the message 'Plugin uploaded successfully'.

Configuring the Katapult Payment Method

Step 1. Go to Extensions > extensions and choose the extension type as payments, then you will see the list of extensions, find katapult.
Step 2. Click on plus sign to activate plugin and click configure plugin.
Step 3. Update details and save the configuration.

  • Private API Key: tokens supplied by Katapult
  • Public API Key: tokens supplied by Katapult
  • Environment - https://sandbox.katapult.com/
  • Status – Enabled
  • Order Status - Select one of the provided in the list.
  • Sort Order - Order of payment option.
  • Status Mapping configures which OpenCart status should be set depending on the Katapult order state.

Attribute Updates

We ask that our merchants mark the appropriate items as leasable during setup. We still allow customers to checkout with leasable and non leasable items. However, they must pay for non leasable items in full at the time of checkout, but don’t worry, we’ll take care of the taxes and the payment. For this to happen you must update your product attributes as leasable.

Not sure which items are leasable? Look at our merchant guide for a list of non leasable items or reach out to us directly at [email protected].

Updating Attributes as leasable:
To update an item as leasable go to Products > find the product(s) that is leasable >go to Edit > Go to Leasable tab > Select ‘Yes/No’ and update the product.

Testing

Merchant Testing
We recommend that your team complete thorough testing, You can find our recommended testing scenarios here. However, you will need to tailor your testing plan specific to your setup and processes.

Katapult Testing
After completing the installation and configuration, we will coordinate testing with your team. Katapult will need to complete testing in your development environment before going live in production.

Deployment

Once testing is completed, we will coordinate training and a go live date. Contact your account manager or reach out to [email protected] to coordinate a go live date.

Production Configuration
Once testing is completed, Katapult will coordinate providing production tokens and deployment.

  • Private API Key: tokens supplied by Katapult
  • Public API Key: tokens supplied by Katapult
  • Environment - https://www.katapult.com/
  • Status – Enabled
  • Order Status - Select one of the provided in the list.
  • Sort Order - Order of payment option.
  • Status Mapping configures which OpenCart status should be set depending on the Katapult order state.

Launch to Production

Once testing and training are complete, you will be ready to deploy to your production environment and make Katapult a payment option for your customers!