Stripe
Conecta tu cuenta de Stripe para que el agente cree enlaces de pago cuando el cliente decide comprar y confirme si ya pagó.
Con Stripe conectado, tu agente puede generar un enlace de pago cuando un cliente decide comprar algo, y revisar si ya se pagó antes de confirmarlo.
Cómo funciona en una conversación#
- El cliente decide comprar un artículo concreto y el importe está claro. Si falta información (qué producto, cuánto), el agente la aclara antes.
- El agente crea el enlace de pago y se lo manda por el chat.
- El cliente completa el pago en la página de Stripe.
- Si el cliente dice «ya pagué», el agente consulta el estado real del enlace antes de confirmar.
Orkestal revisa periódicamente el estado de los enlaces pendientes. No necesitas configurar webhooks de Stripe para este flujo.
El importe se expresa en unidades normales de la moneda (500 significa 500 pesos), nunca en centavos. Si el agente no indica moneda, usa la predeterminada de tu negocio.
Preparar la clave en Stripe#
Orkestal usa una clave de API restringida, para limitar lo que puede hacer.
- En el Dashboard de Stripe, abre Desarrolladores → Claves de API.
- Crea una clave restringida.
- Dale permiso de escritura a Payment Links y deja sin permisos los demás recursos.
- Copia la clave en un lugar seguro: Stripe puede mostrarte el secreto solo al crearla.
Conectar con Orkestal#
- Ve a Integraciones → Stripe.
- Pega la clave y confirma. Orkestal valida la conexión consultando tus enlaces de pago.
- Verás «¡Stripe conectado! El agente ya puede generar links de pago.» La clave queda guardada cifrada.
Empieza en modo de prueba#
Una clave que empieza con sk_test_ crea operaciones de prueba, sin dinero real. Una clave de producción puede generar pagos reales. Prueba primero con claves y datos de prueba de Stripe, y confirma el modo antes de conectar.
Reglas de uso#
Con la cuenta conectada, abre Reglas de uso para el agente, activa la selección inteligente y define cuándo usar Stripe. Mira el panel completo. Ejemplos:
- Cuándo usarla: «Solo cuando el cliente confirme que quiere pagar un producto con precio definido».
- Cuándo no usarla: «No generar enlaces para cotizaciones de más de 10 piezas; pasar con un asesor».
Pulsa Guardar: el enrutador las aplica desde el siguiente mensaje.
Qué ve tu equipo#
El resumen de enlaces de pago (cuántos siguen pendientes y cuánto se cobró) puede consultarse con Orki. El cobro en sí lo ves en tu Dashboard de Stripe.
Con el funnel de ventas#
El funnel de ventas puede terminar con Enviar link de pago: cuando el cliente decide pagar, el agente genera un enlace real de Stripe con el monto de tus documentos. El paso se cumple solo cuando el enlace existe.
Desconectar o rotar la clave#
- Desconectar: Orkestal pide confirmación. El agente deja de poder generar enlaces hasta que vuelvas a conectar.
- Rotaste o revocaste la clave en Stripe: desconecta y vuelve a conectar con la nueva.
Problemas comunes#
| Síntoma | Qué revisar |
|---|---|
| Stripe rechaza la clave | Que sea de la cuenta correcta y que Payment Links tenga permiso de escritura |
| El agente no crea enlaces | Que la conexión esté activa, que las reglas de uso permitan el cobro y que el precio y la moneda estén definidos |
| El cliente pagó, pero no aparece confirmado | Pídele al agente que vuelva a comprobar el estado del enlace; la confirmación depende de la respuesta de Stripe |