Saltar al contenido principal

Configuración de pagos

La configuración de pagos es donde conecta la cuenta de Stripe de su parroquia para que los feligreses puedan pagar estipendios de intenciones de Misa, ofrendas bautismales y otras tarifas en línea. Una vez que Stripe está conectado, cada pago en línea exitoso se asienta directamente en el libro mayor de su parroquia y produce automáticamente un recibo numerado. Los pagos en efectivo y con cheque funcionan sin Stripe — la configuración de pagos solo afecta a los pagos en línea con tarjeta.

La página de configuración de pagos​

Navegue a Panel de administración → Configuración → Pagos. La página está organizada en tres secciones:

  • Plan de suscripción — gestiona su suscripción a Sacramentum (separada del procesamiento de pagos parroquiales).
  • Integración con Stripe — donde ingresa sus claves de Stripe, verifica la conexión y conecta el webhook.
  • Opciones de pago — interruptores que controlan lo que los feligreses pueden hacer al pagar y cómo la parroquia gestiona los pagos a sacerdotes.

Una tarjeta separada de Ofrenda bautismal al final de la página establece el monto sugerido que se muestra en la página pública de registro de bautismo.

Antes de comenzar​

Sacramentum usa Stripe para procesar pagos en línea. Debe tener una cuenta de Stripe activada antes de poder conectarla. Si su parroquia aún no tiene una, regístrese en stripe.com y complete primero los pasos de verificación de identidad y cuenta bancaria de Stripe — Stripe no liberará fondos a la cuenta bancaria de su parroquia hasta que esas verificaciones estén completas.

Mantenga sus claves privadas

Las claves secretas de Stripe otorgan acceso completo a su cuenta de Stripe. Nunca las pegue en chat, correo electrónico, capturas de pantalla o documentos compartidos. Sacramentum cifra las claves secretas en reposo y nunca las muestra completas después de guardarlas — una vez que se almacena una clave, el campo de entrada muestra un marcador de posición en lugar del valor real.

Conectar Stripe​

Necesitará dos valores del Panel de Stripe: una clave publicable (comienza con pk_live_ o pk_test_) y una clave secreta (comienza con sk_live_, sk_test_, o un prefijo de clave restringida rk_).

  1. En Sacramentum, navegue a Configuración → Pagos.
  2. Lea la alerta de Integración con Stripe en la parte superior de la sección. Lista las páginas del Panel de Stripe que necesita visitar.
  3. Abra su Panel de Stripe en una pestaña separada y copie la clave publicable.
  4. Péguela en el campo Clave publicable de Stripe en Sacramentum.
  5. Copie la clave secreta desde su Panel de Stripe y péguela en el campo Clave secreta de Stripe. Haga clic en el icono de ojo para confirmar que la pegó correctamente, luego ocúltela de nuevo.
  6. Haga clic en Guardar.

Una vez guardada, aparece una marca verde junto al campo de la clave publicable que dice "Stripe está configurado". El campo de la clave secreta ahora está vacío — eso es lo esperado. Sacramentum almacena la clave cifrada en el servidor y nunca la envía de vuelta a su navegador.

Modo de prueba vs. modo en vivo

Si desea probar la integración antes de ponerla en producción, use sus claves de prueba de Stripe (con prefijos pk_test_ y sk_test_). Stripe proporciona números de tarjetas de prueba en su documentación que simulan pagos exitosos y fallidos sin cobrar dinero real. Cuando esté listo para que los feligreses realicen pagos reales, reemplace las claves de prueba por claves en vivo (pk_live_ y sk_live_) y guarde nuevamente.

Verificar la conexión​

Después de guardar sus claves, use la tarjeta Asistente de configuración de Stripe para confirmar que todo está bien conectado:

  1. Haga clic en Verificar claves de Stripe. Sacramentum hace una llamada al servidor a Stripe e informa si las claves son válidas y si su cuenta de Stripe está habilitada para pagos manuales.
  2. Si la verificación tiene éxito, aparece una marca verde con el mensaje "Claves de Stripe verificadas".
  3. Haga clic en Crear webhook automáticamente. Esto crea un punto de conexión webhook en su Panel de Stripe apuntando a Sacramentum y almacena el secreto de firma automáticamente.
  4. El indicador de Estado del webhook se actualiza a "Webhook conectado" cuando el punto de conexión está saludable.

Puede enviar un evento de prueba desde su Panel de Stripe en cualquier momento para confirmar que Sacramentum está recibiendo entregas de webhook.

Si el webhook alguna vez muestra "El webhook necesita reparación" — por ejemplo después de rotar sus claves de Stripe — haga clic en Restablecer webhook. Restablecer elimina el punto de conexión existente de Stripe y crea uno nuevo con un nuevo secreto de firma. Use esto siempre que el secreto de firma del webhook falte o esté obsoleto.

Moneda y opciones de pago​

Debajo del Asistente de configuración de Stripe, configure cómo se comporta el pago en línea:

  • Moneda — la moneda en la que se cobran los estipendios y las ofrendas. Compatibles: USD, EUR, GBP, CAD, AUD. La mayoría de las parroquias nunca cambian esto después de la configuración inicial.
  • Requerir pago para intenciones — cuando está activado, los feligreses deben pagar al momento de solicitar una intención de Misa. Cuando está desactivado, las intenciones pueden solicitarse sin pago inmediato y se genera una factura para que el solicitante pague después.
  • Permitir donaciones por encima del estipendio — permite a los feligreses ofrecer más que el estipendio sugerido. Los montos adicionales se asientan en la cuenta de ingresos Ofrendas adicionales (3100).
  • Mostrar cobertura de tarifa de transacción — muestra una casilla opcional al pagar donde el feligrés puede elegir cubrir la tarifa de procesamiento de Stripe para que la parroquia reciba el estipendio completo.
  • Pagos manuales habilitados — cuando está activado, Stripe retiene los fondos en su saldo de Stripe hasta que usted active un pago desde el Panel de Stripe en lugar de pagar automáticamente según un cronograma. La mayoría de las parroquias dejan esto desactivado y confían en el cronograma de pago semanal estándar de Stripe. La configuración enlaza directamente a su página de cronograma de pagos de Stripe para que pueda configurarlo desde un solo lugar.
  • Cubrir estipendios no cobrados en pagos a sacerdotes — controla si los pagos a sacerdotes pueden incluir Misas donde el estipendio fue prometido pero aún no cobrado. El valor predeterminado canónico es desactivado: los sacerdotes solo reciben pago por estipendios que han sido cobrados. Activar esto es útil para parroquias que desean adelantar fondos a los sacerdotes contra estipendios esperados, pero requiere un seguimiento cuidadoso. Vea Pagos a sacerdotes para más detalles.

Ofrenda bautismal​

La tarjeta inferior de la página establece el monto de ofrenda sugerido que se muestra en la página pública de registro de bautismo. Ingrese un monto en dólares (solo dólares enteros). Sacramentum muestra tres niveles de ofrenda al pagar: el monto que establece, 1.5× ese monto y 2× ese monto. Establezca el valor en 0 para ocultar las sugerencias de ofrenda por completo y aceptar lo que la familia elija dar.

Cómo fluyen los pagos por el libro mayor​

Cada pago exitoso de Stripe escribe automáticamente un asiento contable que puede inspeccionar en la sección de Finanzas. La ruta es:

  1. El feligrés paga en línea. Stripe captura los fondos.
  2. Sacramentum recibe un evento webhook de Stripe.
  3. El pago se asienta en Compensación de Stripe (1200) en su catálogo de cuentas.
  4. Se genera un recibo y se hace visible en la pestaña Recibos.
  5. Cuando Stripe paga a la cuenta bancaria de su parroquia según su cronograma de pago, Sacramentum compensa el monto correspondiente desde Compensación de Stripe (1200) a Banco operativo (1000).

Para el panorama completo de cómo los pagos en línea se integran al libro mayor de la parroquia, vea Finanzas y cuentas.

Resolución de problemas​

Las claves no se guardan. Sacramentum solo envía la configuración de pagos al servidor cuando ha editado activamente un campo de pago. Si está guardando desde una pestaña diferente y el botón Guardar indica éxito pero no aparece ninguna configuración de Stripe, cambie a la pestaña Pagos, vuelva a ingresar la clave secreta y guarde de nuevo. La clave publicable debe permanecer visible en el campo después de un guardado exitoso; la clave secreta se borra intencionalmente del formulario por seguridad.

"Claves de Stripe verificadas" pero el webhook no se conecta. Haga clic en Restablecer webhook para eliminar y recrear el punto de conexión. Si el problema persiste, confirme en su Panel de Stripe que la URL del punto de conexión webhook coincide con su dominio de Sacramentum y que no existe otro punto de conexión para la misma parroquia.

El pago de prueba tiene éxito pero no aparece ningún recibo. Verifique el indicador de Estado del webhook. Si no muestra "Webhook conectado", el pago fue capturado por Stripe pero el evento webhook correspondiente nunca llegó a Sacramentum, por lo que no se generó ningún recibo. Restablezca el webhook y vuelva a reproducir el evento de prueba desde su Panel de Stripe.

El campo de clave secreta muestra un marcador de posición, no un valor, después de guardar. Esto es correcto y esperado. Sacramentum cifra la clave al guardar y nunca la muestra de nuevo. Para reemplazar la clave, escriba el nuevo valor en el campo y guarde — el valor cifrado existente se reemplaza. Para dejar la clave sin cambios mientras edita otras configuraciones, deje el campo en blanco.

Guardar sin afectar a Stripe

Puede editar cualquier configuración en cualquier pestaña sin perturbar su configuración de Stripe. Sacramentum solo envía la configuración de pagos al servidor cuando edita activamente un campo de pago, por lo que cambiar la información de la parroquia, las preferencias de correo electrónico o cualquier otra configuración nunca borrará accidentalmente sus claves de Stripe almacenadas.

Qué sigue​

Artículos relacionados​