Stripe Connect

Esta página complementa el quick-start de Conectar Stripe. Aquí entramos en el porqué del modelo Connect y los detalles operativos.

El modelo: cuenta conectada por iglesia

Ministrium usa Stripe Connect Standard: cada iglesia (tenant) tiene su propia cuenta Stripe, conectada a la plataforma Ministrium. Esto significa:

Los fondos van directo a la cuenta de la iglesia (Ministrium nunca toca el dinero).
La identidad legal del beneficiario es la iglesia, no Ministrium.
Los payouts los configura cada iglesia (banco, frecuencia, moneda).
Stripe valida la cuenta con KYC (documentos legales del beneficiario).

Por qué Connect y no marketplace

Modelo	Quién recibe el dinero	Quién emite el recibo	Compliance
Marketplace (Express)	Plataforma → reparte	Plataforma	Plataforma asume PCI y AML
Connect Standard	Iglesia directo	Iglesia	Iglesia es responsable

Para iglesias 501(c)(3), el recibo lo emite la iglesia, no Ministrium. Por eso Standard es el modelo correcto.

Comisiones

Stripe cobra 2.9% + $0.30 USD por transacción de tarjeta (estándar). Para non-profits 501(c)(3), Stripe ofrece 2.2% + $0.30 previa solicitud — Ministrium ayuda a tramitar.

Ministrium no añade fee de plataforma (a diferencia de muchos competidores que cobran 1-2% adicional). El plan SaaS es la única monetización.

Webhooks

Stripe notifica eventos a Ministrium vía webhook. Configurar el endpoint es automático al conectar la cuenta. Eventos suscritos:

payment_intent.succeeded → marca la donación como completada
payment_intent.payment_failed → registra el fallo y notifica
charge.refunded → revierte la donación, recibo correctivo
payout.paid → registra el payout en el ledger
payout.failed → alerta al finance_admin
account.updated → refresca capacidades (ej. si pierde charges_enabled)
customer.subscription.deleted → recurrente cancelada

Si el webhook falla, Stripe reintenta hasta 3 días con backoff exponencial. Ministrium tiene endpoint idempotente.

Webhook signing secret

El secret está en Donaciones → Configuración → Webhook. Sólo org_admin lo ve. Si por alguna razón el webhook deja de llegar, regenere el secret y actualice en Stripe Dashboard.

Múltiples cuentas Stripe (multi-campus avanzado)

Por defecto, una iglesia tiene una cuenta Stripe, y los donativos se enrutan al fondo correcto vía metadata. Iglesias con campuses legalmente separados pueden tener una cuenta Stripe por campus:


Iglesia La Roca (org)
├─ Centro    → cuenta Stripe acct_AAA
├─ Norte     → cuenta Stripe acct_BBB
└─ Online    → cuenta Stripe acct_CCC

Disponible sólo en plan Business+. Requiere validación legal (estatutos del campus como entidad propia).

Métodos de pago soportados

Tarjetas: Visa, MC, Amex, Discover (todas las regiones).
ACH (EE.UU.): $0.80 USD por transacción, sin %.
SEPA (UE): €0.35.
OXXO (México): comisión local.
Apple Pay / Google Pay: incluido sin costo extra.
Link (Stripe): sin costo extra.

ACH es dramáticamente más barato para donaciones grandes recurrentes — anime a sus donantes mayores a usarlo.

Reversiones y disputas

Si un donante disputa una donación con su banco (chargeback):

Stripe notifica → Ministrium marca la donación como disputed.
La iglesia tiene 7 días para enviar evidencia (carta de la iglesia, screenshot del recibo, comunicación previa).
Ministrium tiene una plantilla pre-llenada que se descarga como PDF.
Si la iglesia gana, la donación se revierte a completed. Si pierde, se mantiene disputed y refunded, y el recibo fiscal se invalida.

Saldo y payouts


Saldo disponible:    \$3,247.10  (payout en T+2)
Saldo pendiente:     \$1,840.50  (transacciones aún en clearing)
Próximo payout:      \$3,247.10 → BBVA xxxx-1234, mañana 09:00

Payouts diarios por defecto. Cambiable a semanal o manual en Stripe Dashboard.