Braintree es un servicio de pago creado por PayPal que te permite aceptar donaciones de forma segura en tu sitio web, al tiempo que ofrece a tus donantes la flexibilidad de pagar a través de PayPal, Venmo (en EE. UU.), tarjetas de crédito o débito, o billeteras digitales como Google Pay y Apple Pay.

Instalación

Instalar Charitable Braintree es lo mismo que instalar cualquier otra extensión de Charitable. Si no estás seguro de cómo hacerlo, te recomendamos primero leer nuestra guía para instalar extensiones de Charitable.

Activar la pasarela

Después de haber instalado y activado el plugin Charitable Braintree, necesitas activarlo como pasarela de pago. Si estás en la página de Plugins, puedes hacerlo directamente desde allí haciendo clic en el enlace "Activar pasarela Braintree":

Alternativamente, puedes activar la pasarela a través de la página de configuración de Pasarelas de Pago:

1. Ve a Charitable > Ajustes > Pasarelas de Pago
2. Haz clic en Habilitar Pasarela en el bloque de Braintree.

Configuración

Para aceptar pagos con Braintree, necesitarás configurar Charitable con tus ajustes de Braintree.

1. Ve a Charitable > Ajustes > Pasarelas de Pago.
2. Haz clic en Ajustes de Pasarela.

Configurando tus claves de API

Cuando inicies sesión por primera vez en tu cuenta de Braintree, o si nunca has realizado transacciones a través de ella, verás tu ID de Comerciante, Clave Pública y Clave Privada mostradas inmediatamente al iniciar sesión:

Copia y pega estas claves en tus ajustes de Charitable.

Si no ves esto al iniciar sesión en tu cuenta de Braintree, puedes seguir las instrucciones a continuación para encontrar los detalles relevantes:

1. En la esquina superior derecha de tu panel de Braintree, haz clic en el icono del engranaje y luego en API.
2. Encontrarás tu clave pública en la sección "Claves de API" en la parte superior. Si no aparecen claves de API, haz clic en Generar Nueva Clave de API.
3. Haz clic en el enlace Ver en la columna Clave Privada. En la siguiente pantalla, verás tu Clave Privada, ID de Comerciante y Clave Pública listados.

Usar Braintree en modo de prueba

Para probar cómo funciona Braintree, te recomendamos probarlo primero con una cuenta sandbox. Puedes crear una cuenta sandbox en https://sandbox.braintreegateway.com

Encontrarás tu Clave Pública, Clave Privada y ID de Comerciante de la misma manera que para una cuenta real (ver instrucciones anteriores). Cópialos y pégalos en la sección "Ajustes del modo de prueba" en tus ajustes de Charitable Braintree.

Configuración de métodos de pago adicionales

Además de los pagos con tarjeta, puedes aceptar pagos realizados con PayPal, Venmo (solo en EE. UU.), Apple Pay y Google Pay.

Para aceptar estos métodos de pago, necesitarás activar los métodos de pago en Braintree, así como en tus ajustes de Charitable.

Paso 1: Habilitar métodos de pago en Braintree

1. En la esquina superior derecha de tu panel de Braintree, haz clic en el icono del engranaje y luego en Procesamiento.
2. En la página de Procesamiento, habilita los métodos de pago que desees agregar. La integración de Charitable actualmente soporta PayPal, Venmo, Apple Pay y Google Pay.

Nota: Venmo solo está disponible para cuentas de Braintree con sede en EE. UU., por lo que es posible que no lo veas como una opción para habilitar.

Paso 2: Habilitar métodos de pago en Charitable

Una vez que hayas habilitado los métodos de pago en Braintree, puedes activarlos en Charitable simplemente marcando la casilla:

Habilitar 3D Secure

Charitable se integra perfectamente con la funcionalidad 3D Secure 2 de Braintree, que reduce el fraude, mejora la seguridad y ayuda a cumplir los requisitos de autenticación reforzada de clientes (SCA). Para habilitarla, simplemente marca la casilla:

Configuración de donaciones recurrentes

Si estás utilizando Braintree junto con nuestra extensión Donaciones Recurrentes, hay pasos de configuración adicionales.

Crear un plan de facturación recurrente

Para crear una donación recurrente a través de Braintree, necesitas tener un plan de facturación. Cuando alguien inicia una donación recurrente, se creará una suscripción para ellos, utilizando este plan.

Nota: Aunque los planes que crees en Braintree tendrán un precio fijo, este es un valor predeterminado. Para suscripciones individuales, la suscripción de un donante puede anular estos valores. Por esta razón, es posible utilizar un único plan de facturación recurrente para todas las donaciones recurrentes del mismo período creadas a través de tu sitio web.

Para crear un plan de facturación en tu panel de Braintree:

1. En la navegación superior, haz clic en Suscripciones.
2. En la parte superior de la página, haz clic en Planes.
3. Si estás creando un nuevo plan, haz clic en + Crear Un Plan; si estás agregando un nuevo plan, haz clic en + Nuevo Plan.
4. Para la configuración del plan, introduce el nombre de tu plan, el precio predeterminado, la moneda y la frecuencia de facturación. También puedes preferir especificar un ID de plan y una descripción, aunque ambos son opcionales. Todos los demás ajustes deben dejarse vacíos o sin cambios.
5. Haz clic en Crear.

Una vez que hayas creado tu plan, regresa al panel de tu sitio web y navega a la página de configuración de Braintree (Charitable > Ajustes > Pasarelas de Pago > Ajustes de Pasarela Braintree). Desplázate hacia la sección "Facturación Recurrente":

Selecciona los planes de facturación predeterminados que te gustaría usar para cada período de donación recurrente, tanto para el Modo en Vivo como para el Modo de Prueba. Para el modo de prueba, necesitarás crear planes de facturación en tu panel de sandbox de Braintree.

Usar diferentes planes para diferentes campañas

Puede que te resulte útil definir diferentes planes de facturación recurrente para diferentes campañas. Por ejemplo, esto puede facilitar la búsqueda de todas las donaciones recurrentes a una campaña específica en tu panel de Braintree.

Para hacer esto, primero deberás crear tantos planes como necesites en tu panel de Braintree siguiendo los pasos descritos anteriormente. Puedes dejar sin cambios los ajustes de plan predeterminados en Charitable.

Para cambiar el plan de facturación recurrente utilizado para una campaña específica, edita la campaña en tu panel de WordPress. En la sección “Donaciones recurrentes”, selecciona tu plan de facturación preferido para usar en la campaña. Ten en cuenta que hay configuraciones separadas para el Modo en Vivo y el Modo de Prueba.

Añadir un webhook

Cuando un donante tiene una donación recurrente, Braintree puede enviar notificaciones a tu sitio web a través de un webhook cada vez que ocurran eventos importantes relacionados con la suscripción, tales como:

• Se ha cobrado una renovación
• La donación recurrente ha sido cancelada
• Braintree no pudo procesar la renovación más reciente

Sin un webhook, Charitable no sería alertado de estos eventos, por lo que es importante añadir un webhook.

1. En la esquina superior derecha de tu panel de Braintree, haz clic en el icono del engranaje y luego en API.
2. Haz clic en el enlace Webhooks en la parte superior.
3. Haz clic en + Crear un Nuevo Webhook para añadir tu webhook.
4. Para “URL de destino”, introduce la URL de tu sitio web con el sufijo /charitable-listener/braintree/. Por ejemplo, si tu sitio web es ejemplo.com, tu URL de destino será https://example.com/charitable-listener/braintree/.
5. En “Notificaciones”, marca todas las opciones bajo “Suscripción”.

Una vez que hayas añadido el webhook, haz clic en Comprobar URL para asegurarte de que el webhook está configurado correctamente y puede llegar a tu sitio web. Tu servidor debería responder con un estado 200.

Si estás utilizando Braintree Sandbox para probar cosas, también recomendamos añadir un webhook en tu cuenta sandbox, siguiendo el mismo proceso.