Skip to main content

​
Overview

The Paga con ZIGI plugin provides a comprehensive settings interface to customize the payment gateway experience. All settings are configured through WooCommerce’s payment gateway settings page at WooCommerce → Settings → Payments → Paga con ZIGI.

​
Accessing Settings

1

Navigate to WooCommerce Settings

Go to your WordPress admin dashboard and navigate to WooCommerce → Settings
2

Open Payments Tab

Click on the Payments tab at the top of the settings page
3

Configure Paga con ZIGI

Find Paga con ZIGI in the payment methods list and click Manage or Set up

​
Configuration Fields

The plugin settings are defined in the init_form_fields() method of the Zigi_Payment_WC_Gateway class (paga-con-zigi.php:96-162).

​
Enable/Disable

​
enabled
checkbox
default:"no"
Controls whether the ZIGI payment method is available at checkout.Field Properties:
  • Title: “Habilitar/Deshabilitar”
  • Label: “Habilitar Paga con ZIGI”
  • Type: checkbox
  • Default: no
When enabled, customers will see ZIGI as a payment option during checkout.

​
Payment Method Title

​
title
text
default:"Paga con ZIGI"
The title displayed to customers during checkout.Field Properties:
  • Title: “Título”
  • Type: text
  • Default: Paga con ZIGI
  • Description: “Esto controla el título que el usuario ve durante el pago.”
This appears as the payment method name in the checkout page payment options list.
// Source: paga-con-zigi.php:107-113
'title' => array(
    'title'       => __('Título', 'paga-con-zigi'),
    'type'        => 'text',
    'description' => __('Esto controla el título que el usuario ve durante el pago.', 'paga-con-zigi'),
    'default'     => __('Paga con ZIGI', 'paga-con-zigi'),
    'desc_tip'    => true,
)

​
Payment Method Description

​
description
textarea
default:"Método de pago vía QR ZIGI..."
The description shown below the payment method title at checkout.Field Properties:
  • Title: “Descripción”
  • Type: textarea
  • Default: “Método de pago vía QR ZIGI. Al realizar el pago, debes adjuntar el comprobante con la orden de compra.”
  • Description: “Esto controla la descripción que el usuario ve durante el pago.”
Keep this description concise but informative. Explain that customers need to scan the QR code and upload proof of payment.
// Source: paga-con-zigi.php:114-120
'description' => array(
    'title'       => __('Descripción', 'paga-con-zigi'),
    'type'        => 'textarea',
    'description' => __('Esto controla la descripción que el usuario ve durante el pago.', 'paga-con-zigi'),
    'default'     => __('Método de pago vía QR ZIGI. Al realizar el pago, debes adjuntar el comprobante con la orden de compra.', 'paga-con-zigi'),
    'desc_tip'    => true,
)
​
front_description
textarea
default:"Debes escanear el código QR..."
Instructions displayed in the payment popup modal that appears when customers select ZIGI payment.Field Properties:
  • Title: “Descripción del Popup”
  • Type: textarea
  • Default: “Debes escanear el código QR, hacer clic en continuar para adjuntar la captura (es el único comprobante de pago) y podrás completar la compra.”
This text appears in the popup alongside the QR code to guide customers through the payment process.
// Source: paga-con-zigi.php:121-126
'front_description' => array(
    'title'       => __('Descripción del Popup', 'paga-con-zigi'),
    'type'        => 'textarea',
    'default'     => __('Debes escanear el código QR, hacer clic en continuar para adjuntar la captura (es el único comprobante de pago) y podrás completar la compra.', 'paga-con-zigi'),
    'desc_tip'    => true,
)
The popup description is rendered in functions.php:43-45 and displayed in the payment modal when customers click to pay with ZIGI.

​
Phone Number Configuration

​
number_telephone
text
required
The phone number affiliated with your ZIGI account in Guatemala.Field Properties:
  • Title: “Número de Teléfono Afiliado”
  • Type: text
  • Default: (empty)
  • Description: “Ingresa el número afiliado a ZIGI (Guatemala).”
This phone number will be displayed as a clickable link in the payment popup, allowing customers to add the contact to their phone for easier transfers.
// Source: paga-con-zigi.php:141-147
'number_telephone' => array(
    'title'       => __('Número de Teléfono Afiliado', 'paga-con-zigi'),
    'type'        => 'text',
    'description' => __('Ingresa el número afiliado a ZIGI (Guatemala).', 'paga-con-zigi'),
    'default'     => '',
    'desc_tip'    => true,
)
Phone Number Display: The phone number is displayed in the payment popup with a clickable tel: link (functions.php:36-38): 
<?php if (isset($options['number_telephone']) && !empty($options['number_telephone'])) { ?>
    <span class="telephone-number">
        <a href="tel:<?php echo esc_attr($options['number_telephone']); ?>">
            <?php esc_html_e('Agregar Contacto:', 'paga-con-zigi'); ?> 
            <?php echo esc_attr($options['number_telephone']); ?>
        </a>
    </span>
<?php } ?>

​
Settings Storage

All settings are stored in the WordPress options table under the key woocommerce_zigi_payment_settings. The settings are loaded in the gateway constructor (paga-con-zigi.php:84-87): 
// Load the settings.
$this->init_settings();
$this->title = $this->get_option('title');
$this->description = $this->get_option('description');
$this->enabled = $this->get_option('enabled');

​
Saving Settings

Settings are automatically saved when you click the Save changes button at the bottom of the settings page. The save action is hooked in the constructor: 
// Source: paga-con-zigi.php:90
add_action('woocommerce_update_options_payment_gateways_' . $this->id, array($this, 'process_admin_options'));

​
Best Practices

Your description should:
  • Mention that it’s a QR code payment method
  • Indicate that customers will need to upload proof of payment
  • Be concise (1-2 sentences maximum)
The popup description should provide step-by-step guidance:
  1. Scan the QR code with the ZIGI app
  2. Complete the payment in the app
  3. Take a screenshot of the confirmation
  4. Upload the screenshot as proof
Enter the phone number in a format that’s valid for Guatemala, typically:
  • +502 XXXX-XXXX (with country code)
  • XXXX-XXXX (local format)

​
Troubleshooting

​
Settings Not Saving

If your settings are not being saved:
  1. Check that you have proper WordPress permissions
  2. Verify there are no JavaScript errors in the browser console
  3. Ensure WooCommerce is active and up to date
  4. Check for conflicts with other plugins by temporarily disabling them

​
Phone Number Not Displaying

The phone number only appears in the popup if:
  • The field is not empty
  • The customer has selected ZIGI as their payment method
  • The payment popup is displayed
Verify the field is properly filled in the settings page.

Build docs developers (and LLMs) love

Get started for freeTalk to us