Integración · Cobrar y administrar

Wompi + agentes de IA de Meteor

Conecta Wompi con un agente de IA de Meteor: links de pago por PSE, Nequi, Bancolombia y tarjeta, verificación del cobro y medios habilitados del comercio.

Quiero una demostración Ver todas las integraciones

¿Cómo se conecta Wompi con Meteor?

Meteor se conecta con Wompi para que tu agente de IA arme dentro de la conversación un link de pago que el cliente completa por PSE, Nequi, Bancolombia o tarjeta, verifique si esa transacción quedó aprobada antes de despachar, y responda con qué medios puede pagar tu comercio, incluyendo qué bancos aparecen en PSE. Son 4 herramientas. Es el único conector del catálogo que cobra por los medios locales colombianos: Mercado Pago no procesa PSE ni Nequi. Necesitas la llave pública y la llave privada de tu comercio, las dos del mismo ambiente. El monto se pasa en pesos enteros y la conversión a centavos la hace el conector.

Dónde aplica: Colombia. Wompi es colombiana y cobra únicamente en pesos colombianos. No hay cobro en dólares ni en otra moneda, y los medios que ofrece son los del mercado local.

Qué automatiza

Lo que un agente de Meteor hace con Wompi

Cobrar por PSE o Nequi dentro de la conversación

El agente arma el link de pago con el concepto y el monto y lo envía por el canal. El cliente elige en el checkout de Wompi si paga por PSE, Nequi, Bancolombia, tarjeta o corresponsal.

Confirmar el pago antes de despachar

Con el identificador de la transacción, el agente consulta el estado real y solo da el pago por recibido cuando Wompi responde «aprobada». Un pantallazo no es una confirmación.

Responder «¿con qué puedo pagar?» sin abrir el panel

La lista de medios habilitados sale de la configuración real del comercio, así que el agente no ofrece un medio que ese comercio no tiene activado.

Ensayar el cobro sin mover plata

Con las llaves de prueba, el enlace se genera igual y no cobra nada. La respuesta viene marcada como ambiente de prueba para que nadie confunda un ensayo con una venta.

Reconciliar cada cobro con tu propia referencia

Puedes pasar tu referencia al crear el enlace y esa misma referencia vuelve al consultar la transacción, así el cobro se amarra al pedido o al contacto que lo originó.

4 herramientas

Todo lo que el agente puede pedirle a Wompi

Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.

Herramienta	Qué hace
`wompi_crear_enlace_pago`	Crea el link de pago de un cobro y devuelve la URL lista para enviarla al cliente. El monto se pasa en pesos enteros, nunca en centavos.
`wompi_consultar_transaccion`	Dice si una transacción quedó aprobada, pendiente, rechazada o anulada, con su monto, su medio de pago y su referencia. Se consulta por identificador.
`wompi_listar_medios_pago`	Devuelve los medios de pago habilitados para tu comercio y en qué ambiente están operando las llaves cargadas.
`wompi_listar_bancos_pse`	Lista los bancos disponibles para pagar por PSE, con su código y su nombre. Es la respuesta a «¿aparece mi banco?» antes de mandar el link de pago, y la lista se pide a Wompi cada vez porque cambia sola.

Los límites

Qué NO hace la integración con Wompi

Preferimos decirlo aquí que descubrirlo en la implementación.

No cobra por sí solo. Crear el enlace no mueve un peso: la plata se mueve cuando el cliente entra y paga, y eso solo se sabe consultando la transacción.
No hace cobro recurrente ni suscripciones. Cada período es un enlace nuevo. El cobro automático existe en Wompi y este conector no lo expone, porque mueve plata sin que intervenga una persona.
No reembolsa ni anula un cobro. Devolver una plata ya cobrada se hace desde el panel de Wompi, por una persona.
Cada enlace es de un solo uso. No sirve para cobrar dos veces, ni para reenviárselo a otro cliente: cada venta lleva su propio enlace.
No guarda ni procesa datos de tarjeta. El cliente los digita en el checkout de Wompi; Meteor solo genera el enlace y lee el resultado.

Antes de empezar

Qué necesitas para conectar Wompi

1

Llave pública de tu comercio en Wompi

Está en comercios.wompi.co, en Desarrolladores → Llaves de API, y empieza por «pub_». Es la que consulta transacciones y medios de pago.
2

Llave privada de tu comercio en Wompi

Está en el mismo lugar y empieza por «prv_». Es la que crea los enlaces, y tiene que ser del mismo ambiente que la pública: mezclarlas devuelve un error que no explica el motivo.

Preguntas frecuentes

Preguntas sobre Wompi y Meteor

PSE, Nequi y Bancolombia Transfer, que son los medios con los que se paga de verdad en Colombia. Mercado Pago opera en el país pero no los procesa, así que Wompi es el único conector del catálogo que cierra ese hueco.

Consultando la transacción. Una transacción nace pendiente y solo cuenta como pagada cuando Wompi la reporta aprobada. Mientras tanto el agente dice que está pendiente, no que el pago entró.

No. El link se emite de un solo uso, así que cada venta necesita el suyo. Si un cliente dice que perdió el link, conviene verificar primero si el cobro anterior ya se pagó, para no cobrarle dos veces.

No contra Wompi: su consulta funciona por identificador de transacción y no por referencia. Tu referencia viaja en el cobro y vuelve en la respuesta, así que sirve para reconciliar de tu lado, no para buscar del lado de ellos.

Sí. Con las llaves de prueba el enlace se genera igual y no cobra plata real, y la respuesta viene marcada como ambiente de prueba. Las llaves de prueba y las de producción no se pueden mezclar entre sí.

En pesos enteros. La conversión a centavos que Wompi espera la hace el conector, y por eso rechaza un monto con decimales en vez de redondearlo por su cuenta.

Paso a paso