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

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+22 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).

    How to use

    Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scanned

    Verified clean today

    • Free to download with an account

    Requires

    Wompi
    Cuenta de Wompi (llaves de sandbox)
    curl
    Python 3 (opcional, para scripts/verify_event.py)

    Listedtoday

    What's inside

    Frequently Asked Questions