Title: KueskiPay Gateway
Author: kueski
Published: <strong>October 14, 2024</strong>
Last modified: October 20, 2026

---

Search plugins

![](https://ps.w.org/kueskipay-gateway/assets/banner-772x250.png?rev=3168818)

![](https://ps.w.org/kueskipay-gateway/assets/icon-128x128.png?rev=3168818)

# KueskiPay Gateway

 By [kueski](https://profiles.wordpress.org/edgarnomesque/)

[Download](https://downloads.wordpress.org/plugin/kueskipay-gateway.3.1.0.zip)

 * [Details](https://wordpress.org/plugins/kueskipay-gateway/#description)
 * [Reviews](https://wordpress.org/plugins/kueskipay-gateway/#reviews)
 * [Development](https://wordpress.org/plugins/kueskipay-gateway/#developers)

 [Support](https://wordpress.org/support/plugin/kueskipay-gateway/)

## Description

Choose how many fortnights to pay with Kueski Pay

### Requirements

 * WordPress 6.2 or newer.
 * WooCommerce 7.6 or newer.
 * PHP 7.4 or newer is recommended.

### External services

This plugin connects to services operated by Kueski (Kueski, S.A.P.I. de C.V., SOFOM,
E.N.R.) to show promotional widgets and to create, check and refund payments. The
payment connections are required for the gateway to work. They are made only after
you activate the plugin and enter your Kueski API key.

When Sandbox mode is enabled, the Payments API calls go to `https://payments-api.
staging-pay.kueski.codes` instead of `https://api.kueskipay.com`.

Kueski privacy notices:

 * Customers and users: https://preguntas.frecuentes.kueski.com/hc/es/articles/12385430001563-
   Aviso-de-privacidad-integral-para-clientes-y-usuarios-de-Kueski-S-A-P-I-de-C-
   V-SOFOM-E-N-R
 * Merchants (commercial allies): https://preguntas.frecuentes.kueski.com/hc/es/
   articles/12385599806747-PRIVACY-NOTICE-FOR-THIRD-PARTIES-AND-COMMERCIAL-ALLIES-
   OF-KUESKI-SAPI-DE-CV-SOFOM-ENR

#### Kueski Pay widgets (cdn.kueskipay.com)

 * **What it is:** the script `https://cdn.kueskipay.com/widgets.js`, which shows
   the Kueski Pay installment widget on product and cart pages.
 * **When:** the script is loaded on storefront pages.
 * **Data sent:** your Kueski public API key, whether Sandbox mode is on, the integration
   name (`woocommerce`) and the plugin version. The visitor’s browser also sends
   its usual request data (IP address, User-Agent) to the CDN.
 * **Code:** `public/class-wc-kueski-gateway-public.php` (`kueski_widget_enqueue_scripts()`,`
   add_widget_init()`).

#### Kueski Payments API (api.kueskipay.com)

Every request sends your Kueski API key in the `Authorization` header (refunds send
a short-lived signed token instead, see below), plus the customer’s browser User-
Agent, the request source (web or mobile), and the WordPress, WooCommerce, PHP and
plugin versions. All calls are in `includes/class-wc-kueski-gateway-api.php`.

 1.  **Validate API key:** `GET /v1/validate-keys`
 2.   * **When:** to check that the gateway is available at checkout, when an order
        is placed, and when the plugin’s `kueski/v1/monitoring` REST endpoint is called.
        The result is cached for 12 hours (10 minutes after an error).
      * **Data sent:** your API key.
 3.  **Create payment:** `POST /v2/payment_intents`
 4.   * **When:** a customer places an order with Kueski Pay. The customer is then 
        redirected to Kueski to complete the payment.
      * **Data sent:** the order ID and description, order total and currency, each
        item (name, description, SKU, quantity, price), the shipping address (first
        and last name, street, interior, city, state, postcode, country), the billing
        email and phone number, and the URLs Kueski returns the customer to.
 5.  **Check one payment:** `GET /v2/payment_intents/{id}`
 6.   * **When:** the customer returns to the store from Kueski, and when an admin 
        refreshes a pending refund.
      * **Data sent:** the Kueski payment ID.
 7.  **Check pending payments:** `POST /v2/payment_intents/status`
 8.   * **When:** a WP-Cron task every 5 minutes, only while there are pending Kueski
        orders (up to 3 per run).
      * **Data sent:** the Kueski payment IDs of those orders.
 9.  **Refund a payment:** `POST /v2/payment_intents/{id}/refunds`
 10.  * **When:** an admin issues a refund from the Kueski box on the order screen.
      * **Data sent:** the Kueski payment ID, the refund amount and currency, the reason(`
        merchant_refund`), a reference derived from the refund’s idempotency key, and
        an `Authorization` token (JWT, valid 5 minutes) signed with your private key.
        The private key itself is never sent.

## Blocks

This plugin provides 1 block.

 *   Kp Widget Cart Kp Widget

## Reviews

![](https://secure.gravatar.com/avatar/7670cc36adbadc7f6e68b62b802940f1729427172859f8a3cb11e3c447b2ed19?
s=60&d=retro&r=g)

### 󠀁[Es muy invasivo y poco flexible](https://wordpress.org/support/topic/es-muy-invasivo-y-poco-flexible/)󠁿

 [Manuel](https://profiles.wordpress.org/veganmanuel/) September 1, 2025 1 reply

La instalación es muy fácil de hacer, lo cual me alegró mucho ya que la vez anterior
el protocolo era descargar un archivo e instalarlo con supervisión de Kueski… Ahora
es de lo más sencilloPeeeroo. Avanzaron mucho en la instalación, y sacrificaron 
funcionalidad.Si activas el widget se pone el "anuncio" del medio de pago en todas
partes (página de producto, carrito y página de Checkout), lo cual afea las páginas
y crea confusión porque hay Clientes que asumen que sólo hay un medio de pago (Kueski)
o preguntan (si se animan porque ya habían comprado) si pueden pagar con PayPal 
como antes lo cual interrumpe el proceso de Checkout y ocasiona incluso pérdida 
de ventas En nuestro caso, terminando este mes lo desactivaremos (apagaremos el 
medio de pago) hasta organizar una campaña nueva con Kueski o que arreglen este 
error de estrategia. Mientras tanto, mejor no tenerloOjalá pronto reestablezcan 
la versatilidad que tenían antes

![](https://secure.gravatar.com/avatar/e24775dcfa9c1bca3d3b2327ada1d1ceb3551a438aaafbdde0ef5e873413f3e5?
s=60&d=retro&r=g)

### 󠀁[Deficiente](https://wordpress.org/support/topic/deficiente-2/)󠁿

 [BJOUX](https://profiles.wordpress.org/bjouxmx/) December 13, 2024

El plugin de Kueski Pay Gateway cumple su función básica, pero su implementación
técnica deja mucho que desear. Los problemas recurrentes en los logs del servidor,
la carga inadecuada de traducciones, y los conflictos con WooCommerce hacen que 
la experiencia sea frustrante. Cada actualización parece traer nuevos problemas,
lo que genera más trabajo del necesario para un administrador de tienda.

 [ Read all 2 reviews ](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/)

## Contributors & Developers

“KueskiPay Gateway” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ kueski ](https://profiles.wordpress.org/edgarnomesque/)

[Translate “KueskiPay Gateway” into your language.](https://translate.wordpress.org/projects/wp-plugins/kueskipay-gateway)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/kueskipay-gateway/),
check out the [SVN repository](https://plugins.svn.wordpress.org/kueskipay-gateway/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/kueskipay-gateway/)
by [RSS](https://plugins.trac.wordpress.org/log/kueskipay-gateway/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **3.1.0**
 *  Last updated **2 days ago**
 *  Active installations **300+**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [e-commerce](https://wordpress.org/plugins/tags/e-commerce/)[ecommerce](https://wordpress.org/plugins/tags/ecommerce/)
   [payment gateway](https://wordpress.org/plugins/tags/payment-gateway/)[woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/kueskipay-gateway/advanced/)

## Ratings

 1.5 out of 5 stars.

 *  [  0 5-star reviews     ](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/kueskipay-gateway/reviews/)

## Contributors

 *   [ kueski ](https://profiles.wordpress.org/edgarnomesque/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/kueskipay-gateway/)