Guías · Configuración

Cómo conectar Stripe o PlaceToPay a ModusBill

ModusBill acepta pagos con tarjeta a través de un procesador que el propio bufete conecta: Stripe, o PlaceToPay para los bufetes en los mercados que atiende. El dinero va a la cuenta del bufete en el procesador, nunca pasa por ModusBill. Conectar uno toma unos quince minutos y requiere un administrador del bufete en ModusBill y un acceso de propietario en el procesador. Esta guía cubre ambos, desde encontrar las credenciales hasta pasar a producción.

Antes de empezar

• Usted es administrador del bufete en ModusBill. Los proveedores de pago están en Administración, Configuración del bufete, Proveedores de Pago, en https://app.modusbill.com/FirmPaymentSettings.
• Puede iniciar sesión en el panel del procesador con un acceso que permita ver las claves de API.
• Tiene listos un cliente de prueba y una factura pequeña de prueba. Toda configuración debe terminar con un pago de prueba real.

Cada proveedor tiene un ajuste de Entorno. Entorno de Pruebas es para credenciales de prueba y no cobra nada; Producción es para las reales. Empiece en pruebas.

Conectar Stripe

ModusBill necesita dos valores de Stripe: una clave secreta de API y el secreto de firma de un endpoint de webhook que avisa a ModusBill cuando se paga una factura.

1. Abra el panel de Stripe y, para una primera vez, deje activado el modo de prueba (Test mode).
2. Copie la clave secreta. Vaya a Developers, luego API keys, y copie la Secret key. En modo de prueba empieza con sk_test_; en modo real con sk_live_. Nunca la comparta ni la pegue en otro lugar que no sea el campo de configuración de ModusBill.
3. Cree el webhook. Vaya a Developers, luego Webhooks, y agregue un endpoint. La URL es la dirección de su aplicación ModusBill seguida de /api/paymentwebhook/stripe/confirm, que en la instalación estándar es https://app.modusbill.com/api/paymentwebhook/stripe/confirm. Seleccione los eventos checkout.session.completed y checkout.session.expired.
4. Copie el secreto de firma. Abra el endpoint que acaba de crear y muestre su Signing secret, que empieza con whsec_. ModusBill lo usa para verificar que cada notificación viene realmente de Stripe y rechaza cualquier otra.
5. Ingrese ambos en ModusBill. En Proveedores de Pago, elija Configurar junto a Stripe. Mantenga Entorno en pruebas y, en el cuadro de configuración, ponga secretKey con la clave secreta y webhookSecret con el secreto de firma. Deje currency en usd salvo que el bufete facture en otra moneda. Marque "Establecer como proveedor activo del bufete" y guarde.
6. Pruébelo. Abra una factura de prueba, genere un enlace de pago y ábralo. Pague con la tarjeta de prueba de Stripe 4242 4242 4242 4242, cualquier vencimiento futuro y cualquier código de tres dígitos. En unos segundos la factura en ModusBill debe mostrar el pago y cambiar de estado.
7. Pase a producción. Desactive el modo de prueba en el panel de Stripe y repita los pasos 2 a 4 para obtener la clave real y un endpoint de webhook real con su propio secreto de firma. Edite el proveedor en ModusBill, reemplace ambos valores, ponga Entorno en Producción y guarde. Las claves de prueba y las reales son pares separados y nunca se mezclan.

Opcionalmente, marque "Permitir que los clientes paguen parte de una factura" y fije el pago parcial mínimo que acepta. El cliente ve entonces el saldo completo en la página de pago y puede reducirlo.

Conectar PlaceToPay

PlaceToPay, de Evertec, es una pasarela Web Checkout usada en América Latina y el Caribe. ModusBill necesita las dos credenciales que PlaceToPay emite para un sitio de comercio.

1. Obtenga un sitio de comercio. Su gestor de cuenta en PlaceToPay aprovisiona un sitio de Web Checkout y le entrega, por entorno, un login y una clave secreta (a veces llamada tranKey). Las credenciales de prueba solo funcionan contra el entorno de pruebas de PlaceToPay, y las de producción solo contra producción.
2. Ingréselas en ModusBill. En Proveedores de Pago, elija Configurar junto a PlaceToPay. Mantenga Entorno en pruebas para el par de prueba. En el cuadro de configuración ponga merchantId con el login y apiKey con la clave secreta. Marque "Establecer como proveedor activo del bufete" y guarde.
3. Nada que registrar en un panel. ModusBill envía a PlaceToPay su dirección de notificación con cada solicitud de pago, así que no hay que crear ningún webhook a mano. Si PlaceToPay le pide autorizar una URL de notificación, es la dirección de su aplicación seguida de /api/paymentwebhook/placetopay/confirm, que en la instalación estándar es https://app.modusbill.com/api/paymentwebhook/placetopay/confirm.
4. Pruébelo. Abra una factura de prueba, genere un enlace de pago y ábralo. Complete un pago con las tarjetas de prueba que PlaceToPay documenta para su entorno de pruebas. La factura en ModusBill debe mostrar el pago cuando PlaceToPay lo confirme.
5. Pase a producción. Edite el proveedor, reemplace las credenciales por el par de producción, ponga Entorno en Producción y guarde. La página de pago que ve el cliente se presenta en español.

Qué ocurre después de un pago

El procesador notifica a ModusBill, que registra el pago contra la factura, actualiza su estado y marca el enlace de pago como usado. Si un cliente abandona una página de pago de Stripe, el enlace sigue válido; solo un pago completado lo retira. Los pagos con cheque, transferencia o en persona se siguen registrando a mano desde la página de la factura, para que el saldo sea correcto llegue como llegue el dinero.

Los depósitos en fideicomiso son distintos

Estos dos procesadores son para pagar facturas desde el lado operativo del bufete. Los depósitos con tarjeta a una cuenta de fideicomiso deben liquidarse completos, con la comisión de procesamiento cobrada de la cuenta operativa y no de los fondos del cliente, lo que requiere un procesador preparado para fideicomiso. Las solicitudes de depósito en fideicomiso en línea de ModusBill se están construyendo sobre LawPay por esa razón y todavía no están disponibles con Stripe ni PlaceToPay. Hasta entonces, los depósitos en fideicomiso se registran a partir de cheques, transferencias y efectivo.

Si algo no funciona

• No se puede generar el enlace de pago: el proveedor no está activo, o un ajuste obligatorio está en blanco. Abra el proveedor y compruebe que ambos valores se guardaron.
• El cliente pagó pero la factura no se actualizó: en Stripe, la URL del endpoint de webhook o el secreto de firma están mal, o al endpoint le faltan los eventos. El panel de Stripe muestra cada intento de entrega y la respuesta que devolvió ModusBill.
• Credenciales de pruebas en Producción, o al revés: el procesador rechaza la solicitud. Entorno y credenciales deben ser del mismo par.
• Cualquier otra cosa: escriba a support@modusbill.com con el número de factura y la hora del intento.