Integración · Pagos y cobros
Conectar OpenPay a Igniten
Consulta pagos en vivo. No prepara links de cobro. Puede crear y editar el nombre y el correo de clientes. Los clientes se crean sin cuenta de saldo. Igniten le va a pedir confirmación cada vez antes de cambiar un cliente.
Qué lee Igniten, y qué no
Lee
- cargos, clientes y liquidaciones sólo para consultar, México
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.
dashboard.openpay.mx → Credenciales- En OpenPay México, abra el panel de su comercio → configuración de la API. Va a ver el ID del comercio y la llave privada, una contraseña larga.
- Esta llave no se puede limitar: da acceso total a su cuenta. Igniten sólo la usa para consultar y para crear o editar el nombre y el correo de clientes. No prepara links de cobro y no mueve plata.
- Si no es administrador del comercio, mándele este enlace a quien tenga el permiso.
Salió bien si Ve el ID del comercio y la llave privada.
-
Conectar en Igniten
En Igniten, abra Conexiones y elija OpenPay.
- La dirección de la API ya está puesta: https://api.openpay.mx, la de la cuenta real. No la pegue. Este formulario no pide otra dirección.
- Pegue el código y la llave en sus campos; no los 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 |
|---|---|---|
Llave privada (acceso total) | Esta llave no se puede limitar: da acceso total a su cuenta. Igniten sólo consulta y administra el nombre y el correo de clientes. No prepara links de cobro. 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. Puede crear y editar el nombre y el correo de clientes. Los clientes se crean sin cuenta de saldo.
¿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 → OpenPay → 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.