Skip to content

About

Pagos con Wompi (Colombia) para pretix: PSE, tarjetas, Nequi y más. Plugin AGPL de CapioLab.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

pretix-wompi

Plugin de pago de Wompi (Colombia) para pretix: PSE, tarjetas, Nequi, Daviplata, Botón Bancolombia y los demás medios que el comercio tenga activos en Wompi.

Lo mantiene CapioLab. Está en una versión temprana (0.1): se probó en el ambiente de pruebas (sandbox) de Wompi con pretix 2026.9.1, pero todavía no en producción.

English summary below.

Cómo funciona

  1. El comprador elige "Wompi" al pagar en pretix.
  2. El plugin arma el enlace de pago de Wompi (Web Checkout) con:
    • la referencia del pago en pretix;
    • el monto en centavos;
    • la fecha de vencimiento del pedido;
    • la firma de integridad, que se calcula en el servidor para que nadie pueda cambiar el monto.
  3. El comprador paga en la página de Wompi. Los datos de la tarjeta o de la cuenta nunca pasan por pretix.
  4. El pago se confirma por dos vías, y basta con cualquiera:
    • Regreso del comprador: cuando vuelve a pretix, el plugin consulta la transacción en el API de Wompi con la llave privada.
    • Evento de Wompi (webhook): el plugin verifica el checksum con el secreto de eventos, vuelve a consultar la transacción en el API y solo entonces la aplica. Un evento repetido no paga dos veces.
  5. Una transacción rechazada no cancela el pedido: el comprador puede reintentar con otro medio hasta que el pedido venza. Si después de un rechazo llega una aprobación con la misma referencia, el pago se confirma.

Instalación

Con la imagen Docker oficial de pretix:

FROM pretix/standalone:2026.9.1
USER root
RUN pip3 install --no-cache-dir pretix-plugin-build \
 && DJANGO_SETTINGS_MODULE=pretix.testutils.settings \
    pip3 install --no-cache-dir --no-build-isolation git+https://github.com/CAPIOLAB/pretix-wompi.git@main
USER pretixuser
RUN cd /pretix/src && make production

Así se construyó la imagen de prueba. La compilación del plugin necesita pretix instalado, y por eso se usa --no-build-isolation.

Luego activa el plugin en el evento (Configuración → Plugins).

Configuración

En el evento, en Configuración → Pagos → Wompi:

  • Ambiente de pruebas (sandbox): marcado usa sandbox.wompi.co; desmarcado usa producción.
  • Llave pública (pub_test_… / pub_prod_…).
  • Llave privada (prv_test_… / prv_prod_…): solo se usa en el servidor.
  • Secreto de eventos (test_events_… / prod_events_…).
  • Secreto de integridad (test_integrity_… / prod_integrity_…).

Las llaves se guardan en la configuración de pretix. Nunca las pongas en el código, en el docker-compose ni en git.

En el panel de Wompi, en "URL de Eventos", registra:

https://<tu-dominio-de-pretix>/_pretix_wompi/webhook/

Requisitos y advertencias

  • pretix debe estar publicado con un dominio y HTTPS. Wompi bloquea las direcciones de regreso que apuntan a localhost o 127.0.0.1: responde 403 desde su CDN, verificado el 2026-11-12.
  • Moneda: COP.
  • Reembolsos: el plugin no los ejecuta por el API. Se hacen en el panel de Wompi y se registran a mano en pretix.
  • No hay todavía una tarea periódica que vuelva a consultar los pagos pendientes. Si el evento de Wompi no llega, el pago se confirma cuando el comprador regresa a pretix o al reprocesarlo a mano. Wompi reintenta los eventos fallidos.
  • Datos de prueba de Wompi: https://docs.wompi.co/docs/colombia/datos-de-prueba-en-sandbox/

Pruebas

Las pruebas simulan las respuestas de Wompi; no necesitan red ni llaves:

pip install -e . pytest pytest-django responses
python -m pytest tests

Licencia

Copyright 2026 CapioLab.

Publicado bajo la GNU Affero General Public License v3.0 o posterior (archivo LICENSE), la misma familia de licencia de pretix.

English summary

pretix payment provider for Wompi (Colombia): PSE, cards, Nequi, Daviplata, Bancolombia and every other method enabled on the Wompi merchant account.

  • Uses Wompi Web Checkout with a server-side integrity signature.
  • Confirms payments on buyer return and via Wompi events (webhooks), both re-checked against the Wompi API. The webhook checksum is verified and processing is idempotent.
  • Status: early (0.1). Tested against the Wompi sandbox with pretix 2026.9.1; not yet used in production.
  • Refunds are not executed via API.
  • License: AGPL-3.0-or-later.

About

Pagos con Wompi (Colombia) para pretix: PSE, tarjetas, Nequi y más. Plugin AGPL de CapioLab.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages