Skip to main content

​
What is Paga con ZIGI?

Paga con ZIGI is a payment method plugin for WooCommerce that allows customers to make payments using QR codes through the ZIGI mobile app in Guatemala. The plugin operates similarly to bank transfer payments: customers scan the QR code, complete the payment through the ZIGI app, and upload their payment receipt directly to their order.
ZIGI is backed by Banco Industrial, one of Guatemala’s leading financial institutions, providing secure and reliable payment processing.
This solution is ideal for merchants who want to accept digital payments without high transaction fees or complex integrations.

​
Key Features

Bank Transfer-Style Payment

Simple workflow similar to traditional bank transfers, familiar to customers

QR Code Scanning

Customers scan your QR code directly from the ZIGI mobile app

Receipt Upload

Payment receipts are attached directly to orders for verification

Customizable Messages

Fully customizable payment instructions and descriptions from the admin panel

Amount Limits

Configure minimum and maximum payment amounts with custom messaging

Receipt Visibility

Payment receipts are visible to both customers and store administrators

​
Additional Features

  • Affiliated Phone Number: Option to display your ZIGI-affiliated phone number for customer support
  • QR Code Management: Upload and preview your ZIGI QR code from the WordPress admin
  • Custom Payment Icon: Configure a custom icon for the payment method at checkout
  • HPOS Compatible: Full support for WooCommerce High-Performance Order Storage
  • Simple User Flow: Clear and straightforward payment process for end users

​
Requirements

Before installing Paga con ZIGI, ensure your environment meets these requirements:
1

WordPress Version

WordPress 5.2 or higher (tested up to 6.6)
2

WooCommerce Plugin

WooCommerce must be installed and activated (tested up to 9.3)
3

PHP Version

PHP 7.4 or higher
4

ZIGI Account

Active ZIGI account with a generated QR code (available in Guatemala)
This plugin requires WooCommerce to function. Make sure WooCommerce is installed and activated before installing Paga con ZIGI.

​
How It Works

The payment flow is designed to be simple and secure:
1

Customer Selects Payment Method

At checkout, the customer selects “Paga con ZIGI” as their payment method
2

QR Code Display

A popup modal displays your ZIGI QR code and the total amount to pay
3

Payment via ZIGI App

Customer scans the QR code using their ZIGI mobile app and completes the payment
4

Receipt Upload

Customer uploads a screenshot or image of the payment receipt
5

Order Processing

Order is placed with “on-hold” status, awaiting merchant verification
6

Merchant Verification

Store administrator reviews the receipt in the order details and confirms payment
Orders are automatically set to “on-hold” status until the merchant manually verifies the payment receipt and updates the order status.

​
Payment Gateway Architecture

Paga con ZIGI extends the WC_Payment_Gateway class and integrates seamlessly with WooCommerce: 
class Zigi_Payment_WC_Gateway extends WC_Payment_Gateway
{
    public function __construct()
    {
        $this->id = 'zigi_payment';
        $this->method_title = __('Paga con ZIGI', 'paga-con-zigi');
        $this->method_description = __('Método de pago QR ZIGI.', 'paga-con-zigi');
        
        $this->supports = array('products');
        // ... additional configuration
    }
}
The plugin handles:
  • Payment gateway registration via woocommerce_payment_gateways filter
  • HPOS (High-Performance Order Storage) compatibility
  • Custom form fields for QR code upload and configuration
  • AJAX-based receipt upload functionality
  • Order metadata storage for payment receipts

​
Use Cases

Paga con ZIGI is perfect for:
  • Guatemalan E-commerce Stores: Accept local payments without international gateway fees
  • Small to Medium Businesses: Low barrier to entry with no complex API integrations
  • Manual Order Verification: Businesses that prefer to verify payments before fulfillment
  • Mobile-First Customers: Target customers who prefer mobile payment solutions

​
Security & Verification

The plugin implements several security measures:
  • Nonce Verification: All AJAX requests include WordPress nonce validation
  • File Type Validation: Receipt uploads are restricted to image formats (JPG, PNG, GIF)
  • Sanitized Inputs: All user inputs are properly sanitized and escaped
  • Secure File Handling: Uses WordPress core file upload functions with security checks
  • Custom Upload Directory: Payment receipts stored in dedicated /zigi-payment-qrcode folder
Payment receipts are stored separately in /wp-content/uploads/zigi-payment-qrcode/ for easy management and backup.

​
Next Steps

Installation

Learn how to install and activate the plugin

Quick Start

Get started with your first ZIGI payment

Build docs developers (and LLMs) love

Get started for freeTalk to us