Wompi: pagos en Colombia (no oficial)

    1

    Crea links de pago, consulta transacciones y valida la firma de los webhooks de Wompi (COP). Sandbox por defecto.

    Free

    1 useSecurity scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Wompi: pagos en Colombia (no oficial)

    Example session with this skill installed

    Me llegó este webhook de Wompi en evento.json. ¿Es auténtico? Mi secreto de eventos está en WOMPI_EVENTS_SECRET.

    • Read your context and instructions
    • Compiled the wompi

    Resumen

    La firma del evento es

    válida: el checksum coincide con el que calculé a partir de signature.properties, el timestamp y tu secreto de eventos. Puedes procesarlo.

    Cómo lo verifiqué

    Wompi indica en cada evento qué campos entran en la firma. En este caso:

    PasoValor
    signature.propertiestransaction.id, transaction.status, transaction.amount_in_cents
    Valores leídos de data1234-1610641025-49201, APPROVED, 4490000
    timestamp1530291411
    Cadena firmadavalores + timestamp + secreto (sin separadores)
    SHA256 calculado5a18ec5e8fdb7df4…2ea68a4bc0aefbe
    signature.checksum recibido5a18ec5e8fdb7df4…2ea68a4bc0aefbe

    Lo corrí con el script incluido en el skill (Python, solo librería estándar):

    $ python3 scripts/verify_event.py evento.json
    OK: firma válida
    $ echo $?
    0
    

    Como prueba negativa, cambié status a DECLINED sin volver a firmar:

    $ python3 scripts/verify_event.py evento-alterado.json
    INVÁLIDO: la firma no coincide; ignora este evento
    $ echo $?
    1
    

    Para tu endpoint

    • Valida la firma

    antes de tocar la base de datos y compárala en tiempo constante (timingSafeEqual en Node, hmac.compare_digest en Python).

    • Lee las propiedades desde signature.properties; no las dejes fijas en el código, porque Wompi puede cambiarlas.
    • Responde 200 rápido y haz el procesamiento idempotente por transaction.id: Wompi reintenta el envío si no recibe 200.

    Siguientes pasos

    1. Configura la URL de eventos en el panel de Wompi (sandbox).
    2. Haz un pago de prueba con la tarjeta 4242 4242 4242 4242 y confirma que tu endpoint marca la orden como pagada.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Skill no oficial para integrar Wompi, la pasarela de pagos de Colombia, desde Claude Code, Kiro, Cursor y otros agentes compatibles con SKILL.md.

    Qué hace

    • Crea links de pago (montos en centavos de COP, fechas de expiración en UTC) y devuelve la URL de checkout.
    • Consulta links y transacciones por ID.
    • Valida la firma (checksum) de los eventos/webhooks de Wompi con el algoritmo correcto: lee signature.properties del evento en vez de asumir campos fijos.
    • Sirve como guía para escribir el código de tu integración (Node.js, Python, etc.).

    Seguridad

    • Usa el sandbox por defecto y pide confirmación explícita antes de crear algo con llaves de producción (prv_prod_).
    • Nunca imprime las llaves; se leen de variables de entorno (WOMPI_PRIVATE_KEY, WOMPI_EVENTS_SECRET).
    • Comparación de firmas en tiempo constante.

    Qué incluye

    • SKILL.md con las tareas y las reglas.
    • references/api-reference.md: referencia verificada de la API (llaves, links de pago, transacciones, eventos y firma).
    • references/sandbox.md: datos de prueba (tarjetas, Nequi, PSE, Daviplata y más).
    • scripts/verify_event.py: valida el checksum de un evento. Python, solo librería estándar.

    Código fuente y versión oficial: https://github.com/alejofig/wompi-skill (licencia MIT). Este skill no está afiliado a Wompi ni a Bancolombia.


    English: Unofficial skill for Wompi (Colombia's payment gateway): create payment links, look up transactions and verify webhook event signatures. Sandbox by default, explicit confirmation before using production keys. Source: https://github.com/alejofig/wompi-skill (MIT).

    Skill no oficial: no está afiliado a Wompi ni a Bancolombia. Solo cubre links de pago, consulta de transacciones y validación de eventos; no crea transacciones directas, reembolsos ni suscripciones. Solo COP. Necesitas tus propias llaves de Wompi (se recomienda empezar con las de sandbox).

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    1 use

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 28 days ago

    • Free with an Agensi account

    Requires

    Wompi
    Cuenta de Wompi
    curl

    Permissions

    Terminal / Shell
    Network Access
    Read Files
    Environment Variables

    Allowed Hosts

    wompi.com

    Red: solo llama a la API de Wompi (sandbox.wompi.co / production.wompi.co). Variables de entorno: WOMPI_PRIVATE_KEY y WOMPI_EVENTS_SECRET; el skill nunca las imprime. Terminal: para curl y el script de verificación de firmas.

    Listed28 days ago

    What's inside

    Frequently Asked Questions

    No. Es un proyecto independiente y de código abierto (MIT), no afiliado a Wompi ni a Bancolombia. La referencia de la API se armó a partir de la documentación pública de Wompi.

    Sí. Usa el sandbox de Wompi por defecto e incluye datos de prueba: tarjetas aprobadas y rechazadas, Nequi, PSE, Daviplata y más. Con llaves de producción (prv_prod_) pide confirmación explícita antes de crear cualquier cosa.

    Tu llave privada (WOMPI_PRIVATE_KEY) para crear links y consultar transacciones, y tu secreto de eventos (WOMPI_EVENTS_SECRET) para validar webhooks. Se leen de variables de entorno y el skill nunca las imprime ni las guarda.

    Wompi indica en cada evento qué campos entran en la firma (signature.properties). Muchas integraciones los dejan fijos en el código y fallan cuando cambian. El skill los lee del evento, concatena el timestamp y el secreto, y compara el SHA256 en tiempo constante.

    En cualquier agente compatible con el estándar SKILL.md: Claude Code, Kiro (IDE y CLI), Cursor, Codex CLI, Gemini CLI y otros. También se instala con npx skills add alejofig/wompi-skill.

    En el repositorio de GitHub: https://github.com/alejofig/wompi-skill. Ahí está siempre la versión más reciente.

    New in APIs & Backend