Conectar Stripe

Guarda una conexión Stripe propia de la organización para cobros.

Que se logra

• Resultado: la organización puede usar su cuenta Stripe para aceptar cobros de sus clientes.
• Caso de uso: una agencia conecta Stripe para cobrar anticipos de propuestas aceptadas.
• Se combina con: Payment Links, Apex Checkout y Checkout del proveedor.

Donde esta

• Ruta: /[orgId]/settings/payment-gateways
• Acceso en UI: Settings > Billing & Finance > Payment Gateways > Add Gateway > Stripe
• Componente(s): PaymentGatewaysSettings.tsx

Como funciona

1. Selecciona Stripe.
2. Completa Display name, Publishable key y Secret key; opcionalmente marca Set as default.
3. Pulsa Connect gateway, vuelve a editarlo, copia la URL mostrada y añade Webhook signing secret.

Reglas y validaciones

• Se guardan credenciales del gateway de la organización; los secretos no se devuelven tras guardarse.
• Servicios: organization-payment-gateways y stripe-payment-webhooks.

Backend

• La clave pública debe comenzar por pk_; la secreta por sk_ o rk_.
• El webhook debe incluir checkout.session.completed y payment_intent.succeeded.
• Servicios: organization-payment-gateways (create, patch) y stripe-payment-webhooks (create).

Relaciones

• Requiere: acceso al módulo Finance.
• Dispara / afecta: documentos y relaciones del flujo financiero cuando aplica.