Kiot ZaloPay Payment Gateway

# Kiot ZaloPay Payment Gateway for WooCommerce

Transform your WooCommerce store with seamless ZaloPay payment integration. Kiot ZaloPay Payment Gateway is a professional WordPress plugin that enables your customers to pay through ZaloPay’s comprehensive payment network, supporting 40+ Vietnamese banking apps, international cards, and popular digital wallets.

## Overview

Kiot ZaloPay Payment Gateway seamlessly integrates ZaloPay’s payment infrastructure into your WooCommerce store. Built with WordPress best practices and following WooCommerce payment gateway standards, this plugin provides a secure, reliable, and user-friendly payment solution for Vietnamese e-commerce businesses and international stores targeting the Vietnamese market.

## Key Features

### Multiple Payment Methods

– **ZaloPay App**: Direct payment through ZaloPay mobile application

– **ZaloPay trên Zalo**: Payment within Zalo social network

– **Apple Pay**: Support for Apple Pay transactions

– **ATM Cards**: Vietnamese ATM card payments

– **International Cards**: Visa, Master Card, and JCB support

– **QR Code Payments**: Quick QR code scanning for instant payments

– **40+ Banking Apps**: Integration with major Vietnamese banking applications

– **Flexible Selection**: Enable/disable specific payment methods per your needs

### Secure Payment Processing

– **HMAC-SHA256 Signature**: Industry-standard cryptographic signature validation

– **Secure API Communication**: All transactions use HTTPS encryption

– **Callback Verification**: Automatic IPN (Instant Payment Notification) verification

– **Transaction Security**: Secure transaction ID generation and validation

– **Data Protection**: Secure storage of sensitive payment credentials

– **PCI Compliance**: Follows payment industry security standards

### Sandbox & Production Environments

– **Sandbox Mode**: Test payments safely before going live

– **Production Mode**: Seamless switch to live transactions

– **Environment Switching**: Easy toggle between test and production

– **Test Credentials**: Use ZaloPay sandbox credentials for testing

– **Live Credentials**: Switch to production credentials when ready

### Professional Admin Interface

– **Dedicated Admin Menu**: Centralized dashboard for all ZaloPay activities

– **Gateway Settings**: Comprehensive settings page with all configuration options

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

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

– **Debug Logging**: Detailed logging for troubleshooting and monitoring

– **Status Monitoring**: Real-time payment status tracking

### Complete WooCommerce Integration

– **Full Gateway Support**: Complete WooCommerce payment gateway implementation

– **Refund Support**: Process refunds directly from WooCommerce order page

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

– **Payment Fields**: Custom payment method selection on checkout

– **Mobile Responsive**: Optimized checkout experience on all devices

– **AJAX Support**: Fast, seamless payment processing without page reloads

### Transaction Management

– **Transaction Database**: Complete transaction history stored in database

– **Order Tracking**: Link transactions to WooCommerce orders

– **Status Updates**: Real-time payment status synchronization

– **Transaction IDs**: Unique transaction identifiers for tracking

– **Payment Methods Tracking**: Record which payment method was used

– **Amount Tracking**: Complete financial transaction records

### Advanced Features

– **IPN Callback Handling**: Automatic payment status updates via webhook

– **Return URL Processing**: Handle customer return from payment gateway

– **Payment Query**: Query payment status from ZaloPay API

– **Error Handling**: Comprehensive error handling and user notifications

– **Custom Payment Icons**: Display ZaloPay logo and payment method icons

– **Checkout Optimization**: Streamlined checkout process for better conversion

## 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 production (HTTPS)

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

### Technology Stack

– **Framework**: WordPress Plugin API

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

– **API Integration**: ZaloPay API v2

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

– **Security**: HMAC-SHA256 signature, nonce verification, data sanitization

– **Scheduling**: WordPress hooks and actions

### API Features

– **Payment Creation**: Create payment orders via ZaloPay API

– **Payment Query**: Query payment status in real-time

– **Refund Processing**: Process full and partial refunds

– **Callback Handling**: Secure IPN callback processing

– **Signature Verification**: HMAC-SHA256 signature validation

– **Error Handling**: Comprehensive API error handling and retry logic

## Installation & Setup

### Quick Start

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

2. Activate the plugin through WordPress admin

3. Navigate to WooCommerce > Settings > Payments

4. Find “ZaloPay Payment Gateway” and click “Manage”

5. Enter your ZaloPay credentials (App ID, Key 1, Key 2)

6. Configure payment methods and settings

7. Test in sandbox mode

8. Switch to production when ready

### Configuration Steps

1. **Obtain ZaloPay Credentials**:

   – Register for a ZaloPay merchant account at ZaloPay

   – Navigate to merchant dashboard

   – Generate API credentials (App ID, Key 1, Key 2)

   – Configure callback URLs in ZaloPay dashboard:

     – IPN URL: `https://yourdomain.com/wc-api/kiot_zalopay`

     – Return URL: `https://yourdomain.com/wc-api/kiot_zalopay_return`

2. **Configure Gateway Settings**:

   – Enable/Disable the payment gateway

   – Set payment method title (e.g., “ZaloPay Payment”)

   – Add payment description for customers

   – Enable/Disable sandbox mode

   – Enter ZaloPay App ID

   – Enter ZaloPay Key 1 (for signature)

   – Enter ZaloPay Key 2 (for verification)

   – Select enabled payment methods

   – Enable debug logging (for troubleshooting)

3. **Test Payment Processing**:

   – Enable sandbox mode

   – Use ZaloPay test credentials

   – Place a test order

   – Verify payment flow

   – Check transaction logs

   – Test refund functionality

4. **Go Live**:

   – Switch to production mode

   – Enter production credentials

   – Verify SSL certificate is active

   – Test with small transaction

   – Monitor transaction logs

   – Enable for all customers

## Perfect For

– **Vietnamese E-commerce Stores**: Online retailers targeting Vietnamese market

– **International Stores**: Global stores wanting to accept Vietnamese payments

– **Multi-payment Stores**: Stores offering multiple payment options

– **Mobile Commerce**: Stores with high mobile traffic

– **High-volume Merchants**: Businesses processing many transactions

– **Digital Products**: Sellers of digital goods and services

– **Physical Products**: Retailers selling physical goods

– **Service Providers**: Businesses offering services online

## Benefits

✅ **Accept Vietnamese Payments**: Enable customers to pay through ZaloPay and 40+ banking apps

✅ **Increase Conversion**: Multiple payment options reduce cart abandonment

✅ **Mobile Optimized**: Seamless mobile payment experience

✅ **Secure Transactions**: Industry-standard security and encryption

✅ **Easy Integration**: Simple setup and configuration

✅ **Complete Refund Support**: Process refunds directly from WooCommerce

✅ **Transaction Tracking**: Complete transaction history and logs

✅ **Professional Interface**: Clean, user-friendly admin dashboard

✅ **Reliable Processing**: Robust error handling and retry logic

✅ **WooCommerce Native**: Full integration with WooCommerce ecosystem

## 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

– **Signature Verification**: HMAC-SHA256 signature validation for all callbacks

– **PCI Compliance**: Follows payment industry security best practices

## Payment Methods Supported

### Digital Wallets

– ZaloPay App

– ZaloPay trên Zalo

– Apple Pay

### Card Payments

– ATM Card (Vietnamese banks)

– Visa Card

– Master Card

– JCB Card

### Other Methods

– QR Code Payments

– 40+ Vietnamese Banking Apps

## Support & Documentation

– **Developer Documentation**: Based on ZaloPay API documentation

– **WooCommerce 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

– **Documentation**: https://docs.thenine.store/kiot-zalopay

## What’s Included

– Complete plugin source code

– ZaloPay API v2 integration

– Multiple payment methods support

– License management system

– Admin dashboard interface

– Transaction tracking database

– Migration system for database setup

– Internationalization support (i18n ready)

– Uninstall cleanup functionality

– Comprehensive logging system

– Refund processing system

– IPN callback handling

## Use Cases

### Scenario 1: Vietnamese E-commerce Store

1. Set up ZaloPay payment gateway

2. Enable ZaloPay App and ATM card payments

3. Configure Vietnamese banking apps

4. Test with sandbox credentials

5. Go live and accept payments from Vietnamese customers

### Scenario 2: International Store Targeting Vietnam

1. Add ZaloPay as additional payment option

2. Enable international cards (Visa, Master Card)

3. Enable ZaloPay for Vietnamese customers

4. Keep existing payment gateways active

5. Offer multiple payment options for better conversion

### Scenario 3: Mobile-First Store

1. Enable ZaloPay App payment method

2. Enable Apple Pay for iOS users

3. Enable QR Code payments

4. Optimize checkout for mobile devices

5. Provide seamless mobile payment experience

## Get Started Today

Transform your WooCommerce store with ZaloPay payment integration. Accept payments from Vietnamese customers through ZaloPay, 40+ banking apps, and international cards. Increase conversion rates, reduce cart abandonment, and expand your customer base in Vietnam.

Install Kiot ZaloPay Payment Gateway and start accepting ZaloPay 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+

**ZaloPay Integration**: API v2 support