Cobrar de verdad con Stripe

Esta guía lleva una tienda Sellbase de modo prueba a pagos reales. Tu agente de IA puede hacer casi todo (skills/configure-payments), pero dos pasos son tuyos: activar la cuenta de Stripe y pagar la verificación.

1. Antes de empezar

La tienda ya pasó test_purchase en modo prueba y store_status no tiene nada en rojo, salvo el aviso "Stripe en modo prueba".
El proyecto está desplegado en Supabase con una URL pública (https). En local también se puede, con stripe listen --live.
En la tienda tienes contact_email y settings.site_url (PATCH /store).

2. Activa tu cuenta en Stripe

En dashboard.stripe.com completa los datos del negocio, tu identificación y la cuenta bancaria. Mientras Stripe no habilite los cobros, el doctor marca Pagos en rojo: "cannot take charges yet".

3. Consigue la llave live

En dashboard.stripe.com/apikeys usa la Secret key (sk_live_…). La opción más segura es una restricted key (rk_live_…) con permiso de escritura en:

Checkout Sessions
Payment Intents
Refunds
Webhook Endpoints

y de lectura en Account.

No la guardes en archivos ni la pegues en chats: la conectas tú en el admin (paso 4) y queda cifrada en Supabase Vault.

4. Conecta en modo real

En el admin, Ajustes → Pagos: pega la llave y confirma. Conectar llaves live exige confirmación, porque a partir de ahí los clientes pagan dinero real. La llave va directo a Supabase Vault: no pasa por archivos del proyecto ni por tu agente.

Desplegado: Sellbase crea el webhook en tu cuenta de Stripe (…/functions/v1/sellbase-webhooks/stripe, con los 4 eventos de Checkout) y guarda su secreto en Vault. Si ya existía un endpoint con esa URL, lo reemplaza, porque Stripe solo muestra el secreto una vez.
Local: corre stripe listen --live --forward-to http://127.0.0.1:54321/functions/v1/sellbase-webhooks/stripe y conecta con el whsec_… que imprime.

La respuesta trae next_steps con lo que falta.

5. Verifica con un cobro real

payments_live_check, o el botón "Verificar cobro real" en Ajustes → Pagos, crea un Checkout por el mínimo de Stripe (10 MXN o 0.50 USD). Págalo con tu tarjeta. Cuando llega el webhook, Sellbase lo reembolsa y el doctor marca Verificación de cobro real en verde.

Stripe no devuelve su comisión en reembolsos: la prueba cuesta unos pocos pesos.

6. Qué cambia en modo real

test_purchase ya no corre: nunca cobra dinero real.
Los reembolsos desde el admin o el agente mueven dinero de verdad. Por eso exigen confirm: true y el permiso refunds:write, que los tokens de agente no traen por defecto.
Si vuelves a llaves de prueba, los checkouts abiertos en modo real dejan de poder confirmarse. Hazlo solo en un proyecto de pruebas.

Problemas comunes

Síntoma en el doctor	Qué hacer
Pagos: "cannot take charges yet"	Termina la activación en Stripe y luego usa "Probar conexión".
Webhooks: "no event received yet"	Revisa en Stripe → Developers → Webhooks que el endpoint esté activo. Luego corre la verificación.
Verificación: "refund failed"	Reembolsa desde Stripe → Payments y vuelve a correr la verificación.
El pago no llega en local	`stripe listen --live` debe seguir corriendo y el `whsec_` conectado debe ser el que imprimió.

Raw Markdown for agents: guides/stripe-live.md · Edit on GitHub