Kispay WooCommerce Payment Gateway Integration Guide

1. Introduction

Kispay WooCommerce Plugin allows merchants to accept payments directly through the WooCommerce checkout. This guide explains how to install, configure, test, and verify payment flows.

2. Requirements

• WordPress 6.0+
• WooCommerce 7.0+
• PHP 7.4+
• HTTPS enabled

3. Installation Steps

Step 1: Add Plugin

Go to WordPress Admin → Plugins → Add Plugin

Step 2: Upload Plugin

Click Upload Plugin on the Add Plugins page.

Step 3: Install Plugin

Choose the plugin ZIP file and click Install Now.

Step 4: Activate Plugin

After installation is complete, click Activate.

Step 5: Configure Kispay Settings

1. Navigate to WooCommerce → Settings → Payments → Kispay
2. Select Enable to activate the Kispay Payment Gateway.
3. Enter API Key and Secret Key
4. The plugin automatically generates a webhook URL endpoint
5. Copy the Webhook URL and add it to the Kispay Dashboard to obtain the Webhook Secret.

Step 6: Test Checkout Flow

1. Add a product to the cart
2. Select Kispay as the payment method
3. Click Place Order
4. Complete payment in Sandbox or Production environment

Step 7: Verify Webhook Callback

1. Check WooCommerce order status updates.
2. Confirm the status shows SUCCESS, FAILED, or CANCELLED.
3. If you want to view Kispay logs, you can find them in WooCommerce → Status → Logs.

4. Security Best Practices

• keep your API keys private and secure

• Always use HTTPS on your website

• Do not share webhook or secret keys with anyone.

• Validate webhook signatures using HMAC-SHA256

6. Support

For questions or issues:

• Developer Support: developers@kispay.et
• Merchant Support: support@kispay.et
• Merchant Dashboard: https://merchant.kispay.et