Integración · Pagos y cobros
Conectar PayU a Igniten
Consulta órdenes en vivo. No prepara links de cobro y no cambia nada en su cuenta. Los links se crean en el panel o la app de PayU.
Qué lee Igniten, y qué no
Lee
- órdenes con sus transacciones por número de orden, Colombia
No lee
- Números completos de tarjeta (PAN), códigos de seguridad (CVV) y cuentas bancarias completas.
- No devuelve ni mueve plata. No borra ni fusiona. No captura pagos, no transfiere, no paga liquidaciones ni modifica disputas.
Cómo se conecta
2 pasos · ≈ 10 min
-
Preparar el acceso
Entre al panel de su comercio con permiso de administrador.
merchants.payulatam.com → Credenciales- En PayU Colombia, abra el módulo administrativo → Configuración → Configuración técnica. Va a ver API login y API key, dos contraseñas para consultar sus órdenes.
- Esta API key no se puede limitar: da acceso total a la cuenta. Igniten sólo la usa para consultar órdenes. No prepara links de cobro y no cambia nada.
- Si no es administrador del comercio, mándele este enlace a quien tenga el permiso.
Salió bien si Ve API login y API key.
-
Conectar en Igniten
En Igniten, abra Conexiones y elija PayU.
- La dirección de la API ya está puesta: https://api.payulatam.com, la de la cuenta real. No la pegue. Este formulario no pide otra dirección.
- Pegue cada dato en su campo; no lo pegue en el chat. En el correo, ponga el de quien va a usar esta conexión: sólo esa persona podrá usarla. El administrador de Igniten carga los tokens y puede reasignarlos a otra persona. Después otorga lectura en Roles para esa persona.
Salió bien si La conexión figura configurada. En el chat, escriba: Muéstreme el cobro 123456.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
API key (acceso total) | Esta API key no se puede limitar: da acceso total a la cuenta. Igniten sólo consulta órdenes. No prepara links de cobro y no cambia nada. En el correo va quien va a usar esta conexión: sólo esa persona podrá usarla. El administrador de Igniten carga los tokens y puede reasignarlos a otra persona. | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- 401 o 403: revise la conexión y sus permisos
-
Por qué La clave venció o no tiene permiso.
Qué hacer Vuelva a Conexiones y reemplace la clave; revise los permisos indicados en esta ficha.
- No hay una aplicación conectada y concedida
-
Por qué Falta la conexión o la concesión para esta persona.
Qué hacer Pídale al administrador que le otorgue lectura en Roles. La credencial sola no da permiso.
- 429: el proveedor no pudo responder
-
Por qué Se alcanzó el límite de consultas.
Qué hacer Espere el tiempo que indica el proveedor antes de volver a consultar; acote el pedido.
- Esta API permite consultar por id
-
Por qué El proveedor no ofrece un listado verificado.
Qué hacer Copie el identificador del cobro o de la orden desde su panel y pida consultar ese id.
Los límites, dichos
- Hasta 50 registros y 6 llamadas por proveedor y pedido por defecto; también respeta el techo global de apps.
- El listado no representa un total del negocio. No se agregan filas para inventar un total.
- Sólo la persona cuyo correo se indicó puede usar esta credencial. Las demás personas deben conectar la suya. Nunca se comparte un token de acceso total con la organización.
Preguntas frecuentes
¿Puede mover plata?
No prepara links de cobro y nunca devuelve ni mueve plata. No cambia nada en su cuenta. Los links se crean en el panel o la app de PayU.
¿Qué ve cada persona?
En el correo va quien va a usar esta conexión: sólo esa persona podrá usarla. El administrador de Igniten carga los tokens y puede reasignarlos a otra persona. Nunca se comparte un token de acceso total con la organización.
¿Cuánto tarda?
Calcule 10 minutos cuando ya tiene las credenciales. Pedir acceso a soporte puede tardar más.
¿Dónde pego la clave?
Pegue la clave sólo en Conexiones de Igniten, en el campo oculto. No la pegue en el chat.
¿Cómo lo desconecto?
En Igniten, abra Conexiones → PayU → Desconectar. Revoque también la clave en el proveedor.
¿No soy administrador?
Lo tiene que hacer alguien con permiso de administrador del comercio. Si no es usted, mándele este enlace.
¿Qué no guarda?
Nunca guarda un número completo de tarjeta (PAN), el código de seguridad (CVV) ni una cuenta bancaria completa. Sólo conserva los últimos 4 si vienen como tales. Los pagos se consultan en vivo; no se indexan.
¿Qué países admite?
OpenPay: sólo México. PayU: sólo Colombia. dLocal: API de Payins, sin medios de pago por país ni pagos salientes. Stripe y Mercado Pago: la cuenta que conectó. Los países no verificados quedan afuera.