Gateway ePayco

La integración Gateway ePayco conecta Yampi con ePayco, una de las pasarelas de pago más usadas de Colombia. Al igual que Gateway Wompi, esta integración no vive en las conversaciones: es parte del motor de cobros de la Tesorería de Yampi. Al configurarla, los cobros a tus inquilinos (canon, administración y otros conceptos) se procesan a través de tu propia cuenta de ePayco, con tus credenciales y tus tarifas, y el dinero llega directo a ti.

¿Qué es ePayco?

ePayco es una pasarela de pagos colombiana, respaldada por Davivienda, que permite a miles de comercios recibir pagos en línea. Acepta tarjetas de crédito y débito (Visa, Mastercard, American Express, Diners), pagos PSE desde cualquier banco, Daviplata y pagos en efectivo a través de puntos como Efecty, entre otros medios.

Para una inmobiliaria esto significa una cosa: tus inquilinos pueden pagar el arriendo con el medio que prefieran —incluso en efectivo en un punto físico— y el recaudo entra a tu cuenta de ePayco.

Qué es un "gateway" y qué tiene que ver con la Tesorería

En Yampi, los gateways (Wompi, ePayco y Bold) son las pasarelas por donde viaja el dinero de la Tesorería, el módulo que gestiona los cobros a tus inquilinos. La relación es simple:

• La Tesorería decide qué se cobra y a quién (el canon de julio, la administración, etc.).

• El gateway decide por dónde se cobra: procesa el pago con la tarjeta o la cuenta del inquilino.

Al conectar tu propio gateway, Yampi rutea los pagos por tu cuenta de ePayco. Esto tiene dos ventajas grandes:

• El dinero es tuyo desde el primer momento: el recaudo entra a tu cuenta de ePayco (y de ahí a tu banco), no a una cuenta intermedia.

• Tokenización de métodos de pago: ePayco guarda de forma segura la tarjeta del inquilino y la convierte en un "token". Con ese token, los cobros recurrentes (como el arriendo de cada mes) se procesan automáticamente sin pedirle los datos de la tarjeta cada vez. Los datos reales nunca se almacenan en Yampi.

Antes de empezar

• Una cuenta de comercio activa en ePayco. Si no la tienes, créala en epayco.com. El registro es gratuito; las tarifas se cobran por transacción según tu plan.

• Ser administrador en Yampi, para poder activar integraciones.

• Acceso al dashboard de ePayco (dashboard.epayco.com), de donde vas a copiar las llaves.

Nota: para recibir pagos reales, tu cuenta de ePayco debe estar en modo Producción y con el proceso de verificación del comercio completado. Si tu cuenta es nueva y sigue en modo pruebas, los cobros reales no se procesarán.

Paso 1: copia tus llaves desde el dashboard de ePayco

Este paso se hace fuera de Yampi:

1. Inicia sesión en dashboard.epayco.com.

2. Entra a Integraciones → Llaves API.

3. Allí encontrarás las cuatro llaves que necesitas: PUBLIC_KEY (llave pública), PRIVATE_KEY (llave privada) y, en la sección de llaves secretas, P_CUST_ID_CLIENTE (tu Customer ID, el número que identifica tu comercio) y P_KEY.

4. Copia cada valor completo, sin espacios al inicio o al final.

Importante: la llave privada y la P_KEY son confidenciales, como la clave de tu banco. No las compartas por chat ni correo, y pégalas únicamente en el formulario de Yampi.

Paso 2: abre la integración en Yampi

1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda.

2. En el menú de Ajustes, haz clic en Integraciones.

3. Ubica la tarjeta Gateway ePayco y haz clic en Configurar.

Paso 3: completa el formulario de credenciales

En la pantalla Gateway ePayco, activa el interruptor Habilitado (arriba a la derecha) y completa los campos:

1. URL sandbox y URL producción: las direcciones de la API de ePayco para cada ambiente. Salvo indicación contraria de soporte, déjalas con sus valores por defecto.

2. Ambiente: selecciona Sandbox para hacer pruebas sin dinero real, o Producción para cobros reales. Empieza siempre en Sandbox si es tu primera configuración.

3. Llave pública: la PUBLIC_KEY que copiaste del dashboard de ePayco. Identifica tu comercio ante ePayco.

4. Llave privada: la PRIVATE_KEY. Es la que autoriza operaciones, por eso es confidencial.

5. Customer ID: el P_CUST_ID_CLIENTE, el número que identifica tu cuenta de comercio en ePayco.

6. P key: la P_KEY de ePayco. Firma las confirmaciones de transacción para verificar que ningún dato (monto, referencia) fue alterado en el camino.

Mientras falten credenciales, verás un aviso amarillo en la parte superior: "Agrega las credenciales requeridas antes de cambiar Treasury a gateways propios de la cuenta". Es normal: desaparece cuando completas y guardas la configuración.

Paso 4: prueba la conexión y guarda

1. Haz clic en Probar conexión. Yampi verifica las credenciales directamente contra ePayco antes de guardar nada.

2. Si la prueba es exitosa, haz clic en Guardar gateway.

La tarjeta de Gateway ePayco en Integraciones pasará a mostrar la etiqueta Activado, y la Tesorería podrá rutear cobros por tu cuenta de ePayco.

Si la prueba de conexión falla

Revisa en este orden:

1. Espacios de más: al copiar y pegar se cuela a veces un espacio al inicio o al final. Bórralo en cada campo.

2. Llaves incompletas o intercambiadas: verifica que copiaste cada valor completo y en el campo correcto. Un error frecuente es pegar la P_KEY donde va la llave privada, o el Customer ID incompleto.

3. El ambiente: confirma que el selector Ambiente corresponde a lo que quieres hacer (pruebas o cobros reales).

4. El estado de tu cuenta en ePayco: si tu comercio es nuevo, está en revisión o sigue en modo pruebas, los servicios de producción pueden no estar activos todavía. Confírmalo en dashboard.epayco.com o con el soporte de ePayco.

Si las llaves son correctas y la prueba sigue fallando, escribe a soporte de Yampi indicando el mensaje de error.

Sandbox: prueba sin arriesgar dinero

Con el ambiente Sandbox puedes simular pagos aprobados y rechazados para verificar el flujo de cobro completo sin mover dinero real. A diferencia de otras pasarelas, en ePayco las llaves son las mismas para pruebas y producción: lo que cambia es el modo en que se procesan las transacciones. Cuando termines las pruebas, cambia el Ambiente a Producción en Yampi y verifica que tu cuenta de ePayco esté en modo Producción y verificada.

Cómo deshabilitar el gateway

1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Gateway ePayco.

2. Apaga el interruptor Habilitado y guarda.

Los cobros dejan de rutearse por tu cuenta de ePayco. Tu cuenta de ePayco no se toca: tu historial y saldo siguen intactos en su plataforma.

Preguntas frecuentes

¿Qué diferencia hay entre esta integración y las demás? Las demás integraciones potencian las conversaciones o sincronizan datos. Los gateways (Wompi, ePayco, Bold) son infraestructura de pagos: conectan la Tesorería de Yampi con la pasarela por donde se cobra a tus inquilinos.

¿Qué significa "tokenizar" un método de pago? ePayco guarda la tarjeta del inquilino de forma segura y entrega a cambio un "token", un código que la representa. Los cobros recurrentes (como el arriendo mensual) se hacen con ese token, sin volver a pedir la tarjeta y sin que los datos reales pasen por Yampi.

¿El dinero pasa por Yampi? No. Los pagos se procesan directamente en tu cuenta de ePayco con tus propias credenciales. Yampi orquesta el cobro; el dinero va de tu inquilino a tu cuenta.

¿Cuánto cuesta? Yampi no cobra por activar el gateway. ePayco cobra sus tarifas por transacción según el plan que tengas con ellos; consúltalas en epayco.com.

¿Mis inquilinos pueden pagar en efectivo? Sí, esa es una de las ventajas de ePayco: además de tarjetas, PSE y Daviplata, admite pagos en efectivo en puntos como Efecty. La disponibilidad de cada medio depende de tu plan con ePayco.

¿Qué pasa si cambio o regenero mis llaves en ePayco? La conexión dejará de funcionar con las llaves viejas. Vuelve a este formulario, pega las llaves nuevas, prueba la conexión y guarda.

¿Necesito saber programar? No. Todo se resuelve copiando y pegando las llaves desde el dashboard de ePayco. Los términos técnicos (PUBLIC_KEY, P_KEY, Customer ID) son nombres que usa ePayco, pero el proceso son solo clics.