- Home
- Skills
- APIs & Backend
- Wompi: pagos en Colombia (no oficial)
Wompi: pagos en Colombia (no oficial)
Crea links de pago, consulta transacciones y valida la firma de los webhooks de Wompi (COP). Sandbox por defecto.
Free
Works with the AI Agents you already use
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:
| Paso | Valor |
|---|---|
signature.properties | transaction.id, transaction.status, transaction.amount_in_cents |
Valores leídos de data | 1234-1610641025-49201, APPROVED, 4490000 |
timestamp | 1530291411 |
| Cadena firmada | valores + timestamp + secreto (sin separadores) |
| SHA256 calculado | 5a18ec5e8fdb7df4…2ea68a4bc0aefbe |
signature.checksum recibido | 5a18ec5e8fdb7df4…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
- Configura la URL de eventos en el panel de Wompi (sandbox).
- 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.propertiesdel 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.mdcon 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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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
Permissions
Allowed Hosts
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.