Title: DebugPay Toolkit for Payfast
Author: Ravi Khadka
Published: <strong>14 de julio de 2026</strong>
Last modified: 15 de julio de 2026

---

Buscar plugins

![](https://ps.w.org/debugpay-toolkit-for-payfast/assets/banner-772x250.png?rev=
3607448)

![](https://ps.w.org/debugpay-toolkit-for-payfast/assets/icon-256x256.png?rev=3607448)

# DebugPay Toolkit for Payfast

 Por [Ravi Khadka](https://profiles.wordpress.org/ravikhadka/)

[Descargar](https://downloads.wordpress.org/plugin/debugpay-toolkit-for-payfast.1.1.0.zip)

 * [Detalles](https://es-mx.wordpress.org/plugins/debugpay-toolkit-for-payfast/#description)
 * [Opiniones](https://es-mx.wordpress.org/plugins/debugpay-toolkit-for-payfast/#reviews)
 *  [Instalación](https://es-mx.wordpress.org/plugins/debugpay-toolkit-for-payfast/#installation)
 * [Desarrollo](https://es-mx.wordpress.org/plugins/debugpay-toolkit-for-payfast/#developers)

 [Soporte](https://wordpress.org/support/plugin/debugpay-toolkit-for-payfast/)

## Descripción

DebugPay Toolkit for Payfast helps WooCommerce store owners, developers, and support
teams investigate Payfast payment issues without changing the checkout flow or acting
as a payment gateway.

Use it when Payfast payment activity appears successful but a WooCommerce order 
stays pending, failed, cancelled, on-hold, or unpaid. The plugin creates local payment
logs, order debug panels, and copyable reports that make it easier to compare order
activity, callback delivery, ITN observations, sandbox/live mode signals, and common
mismatch symptoms.

The plugin is diagnostic-first. It records WooCommerce order creation events for
Payfast-related orders, order status changes, likely Payfast ITN/callback metadata
on recognized WooCommerce callback routes, and environment diagnostics. It does 
not change order statuses automatically.

This plugin does not include, register, enable, or replace a payment gateway. For
full logging, your site must already have an active Payfast-compatible WooCommerce
gateway that creates Payfast orders and receives Payfast callbacks. If no compatible
gateway is detected, the admin screen shows setup diagnostics and a non-affiliated
checklist.

DebugPay Toolkit for Payfast is an independent diagnostic tool and is not affiliated
with, endorsed by, or sponsored by Payfast, WooCommerce, Woo, Automattic, or WordPress.

#### Payfast and WooCommerce Diagnostics

The plugin focuses on practical Payfast troubleshooting for WooCommerce stores:

 * Payfast payment logs for order creation, status changes, and likely ITN/callback
   activity.
 * Sandbox, live, or unknown mode labels based on safe signals such as gateway settings
   and endpoint hostnames.
 * Gateway setup diagnostics when a Payfast-compatible WooCommerce gateway is missing
   or inactive.
 * Order-level debug panels for support teams investigating unpaid or stuck orders.
 * Human-readable reports for sharing with developers, hosting support, or gateway
   support teams.

#### Key Features

 * Custom database table for local diagnostic logs.
 * WooCommerce > DebugPay Toolkit admin page.
 * Summary cards, AJAX filters, AJAX pagination, log detail view, CSV export, and
   clear logs action.
 * Settings for logging, retention, maximum logs, customer data masking, and uninstall
   cleanup.
 * WooCommerce order admin payment debug panel.
 * Human-readable copyable debug reports.
 * Sanitized diagnostic report export for developers, agencies, hosting support,
   and store support teams.
 * Built-in issue guide for common Payfast payment gateway and WooCommerce order
   update problems.
 * Issue classification for common payment/order mismatch scenarios.
 * Site diagnostics for WooCommerce, Payfast gateway detection, SSL, permalinks,
   WP debug, and log table status.
 * Setup guidance when no Payfast-compatible WooCommerce gateway is detected.
 * Sandbox/live diagnostics that label activity as Sandbox, Live, or Unknown when
   safe signals are available.
 * WordPress.org Live Preview blueprint for a quick browser-based demo environment.

#### What This Plugin Does Not Do

 * It does not create, register, enable, or replace a Payfast payment gateway.
 * It does not process payments or collect card or bank details.
 * It does not automatically mark orders paid, cancel orders, or retry callbacks.
 * It does not store Payfast passphrases, API secrets, passwords, or sensitive tokens.
 * It does not claim official affiliation with Payfast, WooCommerce, Woo, Automattic,
   or WordPress.

#### Privacy

This plugin does not phone home, track usage, or load remote assets. It stores diagnostic
data locally in your WordPress database.

The plugin avoids storing passwords, secrets, passphrases, API keys, sensitive tokens,
and card or bank details. Diagnostic log rows include event details, order/payment
identifiers, request IP address, and user agent to help administrators investigate
callback delivery. Customer email and billing phone are not stored in log context
and are masked in generated reports by default; report masking can be controlled
in the plugin settings.

Sandbox/live diagnostics are read-only. The plugin may inspect safe gateway settings,
endpoint hostnames, and callback context to label activity as Sandbox, Live, or 
Unknown. It does not modify gateway mode and does not read or store Payfast passphrases,
API secrets, or sensitive credentials.

## Capturas

[⌊DebugPay Toolkit logs screen with Payfast payment diagnostics, filters, pagination,
and issue labels.⌉⌊DebugPay Toolkit logs screen with Payfast payment diagnostics,
filters, pagination, and issue labels.⌉[

DebugPay Toolkit logs screen with Payfast payment diagnostics, filters, pagination,
and issue labels.

[⌊WooCommerce order payment debug panel with timeline, mode labels, and copyable
support report.⌉⌊WooCommerce order payment debug panel with timeline, mode labels,
and copyable support report.⌉[

WooCommerce order payment debug panel with timeline, mode labels, and copyable support
report.

[⌊Setup and diagnostics view for Payfast-compatible gateway detection, sandbox/live
mode, and site checks.⌉⌊Setup and diagnostics view for Payfast-compatible gateway
detection, sandbox/live mode, and site checks.⌉[

Setup and diagnostics view for Payfast-compatible gateway detection, sandbox/live
mode, and site checks.

## Instalación

 1. Upload the plugin folder to `/wp-content/plugins/debugpay-toolkit-for-payfast/`.
 2. Activate the plugin from the Plugins screen.
 3. Make sure a Payfast-compatible WooCommerce payment gateway is installed and enabled
    if you want full payment logging.
 4. Open WooCommerce > DebugPay Toolkit.
 5. Confirm logging is enabled and review diagnostics.

## Preguntas frecuentes

### Is this a Payfast payment gateway for WooCommerce?

No. This plugin is a Payfast payment diagnostics and logging tool for WooCommerce.
You still need an active Payfast-compatible WooCommerce gateway to accept payments
and receive full logging.

### Will this fix Payfast orders that stay pending?

No. The plugin does not change order status or alter payment processing. It helps
identify why a Payfast-related WooCommerce order may remain pending, failed, cancelled,
on-hold, or unpaid.

### Does this plugin change WooCommerce order statuses?

No. The plugin only logs diagnostics and builds reports. It does not mark orders
paid, cancel orders, or retry callbacks.

### Can it diagnose Payfast ITN or callback problems?

Yes, it can log likely Payfast ITN/callback activity on recognized WooCommerce callback
routes and show whether an ITN was observed. It does not take over gateway validation
or guarantee that a callback was accepted by the payment gateway.

### Does this plugin validate Payfast signatures?

Only when a verified value is available from a safe integration point. The plugin
does not request or store your Payfast passphrase and does not replace the gateway
validation flow, so callback observations usually show signature status as “Unknown”
rather than pretending validation passed.

### Does it compare Payfast paid amount with the WooCommerce order total?

Only when both values are safely available. If the plugin cannot confidently compare
the paid amount and order total, the amount check remains “Unknown”.

### Does it detect Payfast sandbox and live mode?

The plugin labels activity as Sandbox, Live, or Unknown when safe signals are available
from gateway settings, endpoint URLs, or callback context. If the mode cannot be
verified confidently, it displays “Unknown”.

### Does this plugin change sandbox or live mode?

No. Sandbox/live diagnostics are read-only. If the mode cannot be verified confidently,
the plugin displays “Unknown”.

### What should I do if it shows “Gateway mode unknown”?

Review your Payfast-compatible gateway settings and confirm whether the gateway 
is configured for sandbox or live credentials. The plugin will not modify that setting.

### What happens if WooCommerce or Payfast is inactive?

The plugin does not fatal error. It shows an admin notice if WooCommerce is unavailable
and reports Payfast gateway detection as no or unknown where appropriate. If no 
Payfast-compatible WooCommerce gateway is detected, it shows setup guidance and 
a checklist. It does not provide or enable a payment gateway.

### Is customer data stored in the logs?

The plugin stores local diagnostic data such as event details, order/payment identifiers,
request IP address, and user agent. Customer email and billing phone are not stored
in log context and are masked in generated reports by default.

### Does the plugin send data to an external service?

No. It does not phone home, track usage, or load remote assets. Diagnostic data 
is stored locally in your WordPress database.

### Can I delete plugin data on uninstall?

Yes. Enable “Delete data on uninstall” in WooCommerce > DebugPay Toolkit before 
uninstalling.

## Reseñas

No hay reseñas para este plugin.

## Colaboradores y desarrolladores

Este software es de código abierto. Las siguientes personas han contribuido a este
plugin.

Colaboradores

 *   [ Ravi Khadka ](https://profiles.wordpress.org/ravikhadka/)

[Traduce “DebugPay Toolkit for Payfast” a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/debugpay-toolkit-for-payfast)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/debugpay-toolkit-for-payfast/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/debugpay-toolkit-for-payfast/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/debugpay-toolkit-for-payfast/)
por [RSS](https://plugins.trac.wordpress.org/log/debugpay-toolkit-for-payfast/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 1.1.0

 * Added a sanitized diagnostic report export for Payfast and WooCommerce payment
   troubleshooting.
 * Added a read-only Issue Guide tab explaining common Payfast payment gateway problems,
   ITN/callback symptoms, sandbox/live mismatch, amount mismatch, and WooCommerce
   order status issues.
 * Added recent log observations and site diagnostics to the export report without
   storing or exposing Payfast passphrases, API secrets, passwords, card data, or
   bank details.
 * Improved support workflow for developers, agencies, and store owners investigating
   Payfast orders that remain pending, failed, cancelled, on-hold, or unpaid in 
   WooCommerce.
 * Kept all new features diagnostic-only: no payment gateway creation, no gateway
   setting changes, and no automatic WooCommerce order status changes.

#### 1.0.0

 * Initial release with local Payfast payment logging, WooCommerce order diagnostics,
   likely ITN/callback observations, AJAX filters, CSV export, sandbox/live labels,
   issue classification, setup checks, privacy masking, and HPOS-compatible order
   panels.

## Meta

 *  Versión **1.1.0**
 *  Última actualización **hace 4 horas**
 *  Instalaciones activas **Menos de 10**
 *  Versión de WordPress ** 6.0 o superior **
 *  Probado hasta **7.0.1**
 *  Versión de PHP ** 7.4 o superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/debugpay-toolkit-for-payfast/)
 * Etiquetas:
 * [diagnostics](https://es-mx.wordpress.org/plugins/tags/diagnostics/)[payfast](https://es-mx.wordpress.org/plugins/tags/payfast/)
   [payment gateway](https://es-mx.wordpress.org/plugins/tags/payment-gateway/)[payment logs](https://es-mx.wordpress.org/plugins/tags/payment-logs/)
   [woocommerce](https://es-mx.wordpress.org/plugins/tags/woocommerce/)
 *  [Vista avanzada](https://es-mx.wordpress.org/plugins/debugpay-toolkit-for-payfast/advanced/)

## Valoraciones

Aún no se han enviado valoraciones.

[Your review](https://wordpress.org/support/plugin/debugpay-toolkit-for-payfast/reviews/#new-post)

[Ver todas las valoraciones](https://wordpress.org/support/plugin/debugpay-toolkit-for-payfast/reviews/)

## Colaboradores

 *   [ Ravi Khadka ](https://profiles.wordpress.org/ravikhadka/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/debugpay-toolkit-for-payfast/)