Integración · Pagos y cobros
Conectar Stripe a Igniten
Consulta pagos en vivo. Puede crear Payment Links (links de cobro), clientes, precios para un producto existente y cupones de un solo uso; puede editar nombre y correo de clientes. Igniten le va a pedir confirmación cada vez antes de cambiar algo.
Qué lee Igniten, y qué no
Lee
- cobros y Payment Intents (intenciones de pago)
- reembolsos sólo para consultar
- clientes y suscripciones
- facturas, saldo, movimientos de saldo, liquidaciones y disputas sólo para consultar
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
3 pasos · ≈ 10 min
-
Preparar el acceso
Entre al panel de su comercio con permiso de administrador.
dashboard.stripe.com → Credenciales- En Stripe, abra Developers → API keys → Create restricted key. Va a ver la lista de permisos para la clave restringida (una contraseña con acceso limitado).
- Si no es administrador, mándele este enlace a quien tenga el permiso.
Salió bien si Ve la sección de credenciales de su comercio.
-
Elegir el acceso mínimo
Cree credenciales para esta conexión y revise sus permisos.
- Cree dos claves restringidas distintas: una con Read (lectura) en los diez recursos de la ficha, y otra con Write (escritura) sólo en Payment Links, Customers, Prices y Coupons. Deje el resto en None (sin acceso). No pegue la misma clave en ambos campos.
- Igniten le va a pedir confirmación cada vez antes de cambiar algo. Nunca devuelve ni mueve plata.
Salió bien si Tiene las credenciales y sabe qué permiten consultar.
-
Conectar en Igniten
En Igniten, abra Conexiones y elija esta integración.
- La dirección de la API ya está puesta: https://api.stripe.com. No la pegue. Las pruebas usan el mismo lugar, con claves que empiezan con rk_test_.
- Pegue cada clave en su campo; no las 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. Si la clave es de la organización, otorgue lectura en Roles.
Salió bien si La conexión figura configurada; pida consultar un cobro por id para comprobar el acceso.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
Charges: Read | Consultar Charges. | Siempre |
Payment Intents: Read | Consultar Payment Intents. | Siempre |
Refunds: Read | Consultar Refunds. | Siempre |
Customers: Read | Consultar Customers. | Siempre |
Subscriptions: Read | Consultar Subscriptions. | Siempre |
Invoices: Read | Consultar Invoices. | Siempre |
Balance: Read | Consultar Balance. | Siempre |
Balance Transactions: Read | Consultar Balance Transactions. | Siempre |
Payouts: Read | Consultar Payouts. | Siempre |
Disputes: Read | Consultar Disputes. | Siempre |
Payment Links: Write | Preparar Payment Links sólo después de confirmar la tarjeta. | Siempre |
Customers: Write | Preparar Customers sólo después de confirmar la tarjeta. | Siempre |
Prices: Write | Preparar Prices sólo después de confirmar la tarjeta. | Siempre |
Coupons: Write | Preparar Coupons sólo después de confirmar la tarjeta. | 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.
- Use una clave restringida
-
Por qué Pegó una clave secreta completa que empieza con sk_live_ o sk_test_.
Qué hacer Cree una restricted key (clave con permisos limitados), que empieza con rk_, y marque únicamente los permisos de esta ficha.
- Use claves restringidas distintas para lectura y acciones.
-
Por qué Pegó la misma clave en los dos campos.
Qué hacer Cree otra clave restringida en Stripe con los permisos de acciones de esta ficha. Péguela en el campo de acciones y deje la de lectura en su campo.
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.
- Si se guarda para una persona, sólo ella puede usar la clave. Para la organización, use una clave restringida de integración y otorgue lectura por persona desde Roles; cada persona concedida ve los objetos que permite esa clave.
Preguntas frecuentes
¿Puede mover plata?
Igniten puede preparar links de cobro; nunca devuelve ni mueve plata. Puede crear Payment Links (links de cobro), clientes, precios para un producto existente y cupones de un solo uso; puede editar nombre y correo de clientes.
¿Qué ve cada persona?
Si se guarda para una persona, sólo ella puede usar la clave. 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. Para la organización, use una clave restringida de integración y otorgue lectura por persona desde Roles; cada persona concedida ve los objetos que permite esa clave.
¿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 → Stripe → 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.