Payoo Payment Gateway for Woocommerce

# Kiot Alepay Installment Payment Gateway for WooCommerce

Transform your WooCommerce store with seamless Alepay installment payment integration. Kiot Alepay Installment Payment Gateway is a professional WordPress plugin that enables your customers to pay for purchases in installments through major Vietnamese banks using Alepay’s secure payment infrastructure.

## Overview

Kiot Alepay Installment Payment Gateway seamlessly integrates Alepay’s installment payment system into your WooCommerce store. Built with WordPress best practices and following WooCommerce payment gateway standards, this plugin provides a secure, reliable, and user-friendly installment payment solution for Vietnamese customers.

## Key Features

### Installment Payment Processing

– **Multiple Bank Support**: Integrate with major Vietnamese banks including Vietcombank, BIDV, Techcombank, Agribank, and many more

– **Real-time Cost Calculation**: Accurate installment cost calculation through Alepay API v3

– **Flexible Installment Periods**: Support for various installment periods (3, 6, 9, 12, 18, 24 months)

– **Bank Selection**: Customers can choose their preferred bank for installment payments

– **Automatic Calculation**: Real-time calculation of monthly payments and total amounts

### Product-Level Control

– **Per-Product Settings**: Enable or disable installment options for specific products

– **Product Page Display**: Show installment information directly on product pages

– **Shop Loop Display**: Display installment badges in product listings

– **Minimum/Maximum Amounts**: Set minimum and maximum order amounts for installment eligibility

– **Smart Visibility**: Automatically hide installment options for ineligible products

### Payment Gateway Features

– **WooCommerce Integration**: Full WooCommerce payment gateway standard compliance

– **Secure Payment Processing**: Industry-standard security with checksum validation

– **Sandbox & Production Modes**: Test your integration safely before going live

– **Order Management**: Automatic order status updates based on payment status

– **Transaction Tracking**: Complete transaction history and order metadata

– **Refund Support**: Full refund processing capability

### User Experience

– **AJAX-Powered Interface**: Fast, responsive checkout experience

– **Real-time Updates**: Instant installment calculation without page reload

– **Clear Information Display**: Easy-to-understand installment plans and costs

– **Mobile-Optimized**: Perfect payment experience on all devices

– **Bank Selection Interface**: User-friendly bank selection dropdown

– **Installment Calculator**: Interactive calculator on product pages

### Admin Features

– **Easy Configuration**: Simple setup through WooCommerce payment settings

– **License Management**: Built-in license activation and validation system

– **Admin Dashboard**: Dedicated admin menu for license and settings management

– **Product Meta Boxes**: Easy installment settings for individual products

– **API Connection Testing**: Test API connection before going live

– **Comprehensive Logging**: Complete transaction and error logging

### Technical Features

– **Database Caching**: Cache installment calculations for improved performance

– **API v3 Integration**: Latest Alepay API v3 for maximum compatibility

– **Secure Callback Handling**: Secure webhook endpoints for payment status updates

– **Error Handling**: Comprehensive error handling and user-friendly messages

– **Performance Optimization**: Efficient database queries and caching strategies

## Technical Specifications

### Requirements

– **WordPress**: 5.0 or higher

– **WooCommerce**: 5.0 or higher

– **PHP**: 7.4 or higher

– **MySQL**: 5.7 or higher

– **SSL Certificate**: Required for secure payment processing

– **Alepay Account**: Active Alepay merchant account with API credentials

### Technology Stack

– **Framework**: WordPress Plugin API

– **Payment Gateway**: WooCommerce Payment Gateway Standard

– **API Integration**: Alepay API v3

– **Database**: WordPress database abstraction layer (wpdb)

– **Security**: WordPress nonce verification, data sanitization, SQL injection prevention

– **Caching**: Database caching for installment calculations

### API Features

– **Installment Plans**: Get available installment plans for order amounts

– **Bank List**: Retrieve list of supported banks

– **Cost Calculation**: Calculate installment costs for specific periods and banks

– **Order Creation**: Create installment orders in Alepay system

– **Status Query**: Query order status from Alepay

– **Callback Verification**: Secure callback verification with checksum validation

### Database Tables

– **Installments Cache Table**: Stores cached installment calculations for performance optimization

## Installation & Setup

### Quick Start

1. Upload the plugin to `/wp-content/plugins/kiot-alepay/`

2. Activate the plugin through WordPress admin

3. Navigate to Kiot Alepay > License and activate your license key

4. Go to WooCommerce > Settings > Payments

5. Enable “Alepay Installment Payment” gateway

6. Configure your Alepay API credentials:

   – Token Key

   – Encrypt Key

   – Checksum Key

   – Environment (Sandbox/Production)

7. Set minimum and maximum amounts

8. Test in sandbox mode

9. Switch to production when ready

### Configuration Steps

1. **Obtain Alepay Credentials**:

   – Contact Alepay to set up a merchant account

   – Obtain Token Key, Encrypt Key, and Checksum Key

   – Note your environment (sandbox or production)

2. **Activate License**:

   – Enter your license key in Kiot Alepay > License

   – Verify license activation

3. **Configure Gateway**:

   – Enable the payment gateway in WooCommerce settings

   – Enter all API credentials

   – Set minimum and maximum amounts

   – Choose environment (sandbox for testing)

4. **Configure Products**:

   – Enable installment for specific products

   – Set product-level installment settings

   – Configure display options

5. **Test Integration**:

   – Test API connection

   – Create test orders in sandbox mode

   – Verify installment calculations

   – Test checkout flow

6. **Go Live**:

   – Switch to production environment

   – Update API credentials if needed

   – Monitor transactions and logs

## Perfect For

– **E-commerce Stores**: Online retailers selling to Vietnamese customers

– **High-Value Products**: Stores selling expensive items that benefit from installment payments

– **Electronics Retailers**: Electronics and appliance stores

– **Fashion & Luxury Goods**: Fashion and luxury product retailers

– **Furniture Stores**: Furniture and home goods retailers

– **Vietnamese Market**: Businesses targeting Vietnamese customers

– **B2C E-commerce**: Business-to-consumer online stores

## Benefits

✅ **Increase Sales**: Enable customers to purchase high-value items with installment payments

✅ **Higher Conversion Rates**: Reduce cart abandonment with flexible payment options

✅ **Customer Satisfaction**: Provide convenient payment options for customers

✅ **Competitive Advantage**: Stand out with installment payment options

✅ **Secure Transactions**: Bank-level security with Alepay’s trusted infrastructure

✅ **Easy Integration**: Simple setup process, no coding required

✅ **Reliable Service**: Built on proven WooCommerce and WordPress architecture

✅ **Professional Support**: License-based premium plugin with dedicated support

## Security & Compliance

– **WordPress Security Standards**: Follows WordPress coding standards

– **Data Sanitization**: All inputs are sanitized and validated

– **SQL Injection Prevention**: Uses WordPress $wpdb->prepare() for all queries

– **Nonce Verification**: CSRF protection for all admin actions

– **Secure API Communication**: HTTPS-only API endpoints

– **Credential Encryption**: Secure storage of sensitive API keys

– **Checksum Validation**: Industry-standard checksum validation for all API responses

– **Callback Security**: Secure webhook endpoints with verification

## Supported Banks

The plugin supports all major Vietnamese banks integrated with Alepay, including:

– **Vietcombank** (VCB)

– **BIDV** (Bank for Investment and Development of Vietnam)

– **Techcombank** (TCB)

– **Agribank** (Vietnam Bank for Agriculture and Rural Development)

– **Vietinbank** (Vietnam Joint Stock Commercial Bank for Industry and Trade)

– **ACB** (Asia Commercial Bank)

– **Sacombank** (Saigon Thuong Tin Commercial Joint Stock Bank)

– **VPBank** (Vietnam Prosperity Joint Stock Commercial Bank)

– **And many more…**

## Support & Documentation

– **Developer Documentation**: Based on Alepay API v3 documentation

– **WordPress Integration**: Full WooCommerce payment gateway compatibility

– **Transaction Management**: Complete transaction tracking and history

– **Error Handling**: Comprehensive error messages and logging

– **Support**: Priority support for license holders

– **Email Support**: support@thenine.store

– **Website**: https://thenine.store

## What’s Included

– Complete plugin source code

– Alepay API v3 integration

– Multiple bank support

– Product-level installment control

– License management system

– Admin dashboard interface

– Database caching system

– Migration system for database setup

– Internationalization support (i18n ready)

– Uninstall cleanup functionality

– Comprehensive error handling

– Performance optimization features

## Use Cases

### Scenario 1: Electronics Store

1. Enable installment for high-value electronics

2. Set minimum amount (e.g., 5,000,000 VND)

3. Display installment options on product pages

4. Customers can choose 6, 12, or 24-month plans

5. Increase sales of expensive items

### Scenario 2: Furniture Store

1. Enable installment for all furniture products

2. Set flexible minimum amounts

3. Show installment calculator on product pages

4. Customers can spread payments over 12-24 months

5. Reduce cart abandonment

### Scenario 3: Fashion & Luxury Goods

1. Enable installment for premium products

2. Set product-specific installment settings

3. Display installment badges in product listings

4. Offer flexible payment terms

5. Attract more customers with payment options

## Get Started Today

Transform your WooCommerce store with seamless Alepay installment payment integration. Enable your customers to purchase high-value items with flexible payment plans. Install Kiot Alepay Installment Payment Gateway and start accepting installment payments today!

—

**Plugin Version**: 1.0.0

**Author**: Kiot Team

**License**: GPL v2 or later

**Requires**: WordPress 5.0+, WooCommerce 5.0+, PHP 7.4+

**Alepay Integration**: Full API v3 support