cerebro

Braintree es un conector auto-servicio basado en tres valores: un ID de comerciante, una clave pública y una clave privada. Lo que determina si la conexión es funcional es el rol de acceso limitado que se asigna al usuario de la API: si no se configura correctamente, las transacciones pueden fallar sin generar ningún error.

Lo que obtienes#

Transacciones con datos de pago enmascarados, facturación recurrente y registros de suscripción, disputas, registros de clientes y métodos de pago, verificaciones y datos de estado y informes. Las definiciones a nivel de campo se encuentran en Diccionario de datos de Athia.

Ideal para suscripciones. Braintree ofrece la funcionalidad de facturación recurrente que la mayoría de los conectores de tarjetas no ofrecen, lo que lo convierte en la fuente de referencia para el éxito de las renovaciones y para la cancelación involuntaria debido a errores en las renovaciones.

Menos potente cuando los permisos son limitados. El alcance depende directamente del rol que se otorga; las disputas y los clientes son los ámbitos que suelen desaparecer.

Antes de comenzar#

En el panel de control de Braintree, cree un rol de acceso limitado para Athia y asigne este rol al usuario de la API. El rol debe tener:

• Transacciones: Descargar Transacciones con Datos de Pago Enmascarados
• Informes: Crear, Ejecutar y Descargar Informes; Ver Gráficos del Panel de Control
• Facturación Recurrente: Descargar Registros de Suscripción, Ver Modificaciones, Ver Planes de Suscripción, Ver Suscripciones, Buscar Suscripciones
• Gestión de Disputas: Ver, gestionar y resolver disputas
• Ganchos web: Gestionar Webhooks (Añadir/Editar/Eliminar)
• Estados: Ver Estados
• Acceso de Solo Lectura: Ver Dirección, Ver Clientes, Ver Cuentas de Comerciante, Ver Métodos de Pago, Ver Transacciones, Ver Verificaciones, Descargar Archivos
• Buscar: Buscar Transacciones, Buscar Verificaciones

Ver Dirección y Ver Clientes son los que suelen faltar. Sin ellos, las tablas de dirección y clientes se sincronizan vacías y no se genera ningún error.

Luego, asigne el usuario de la API a todas Cuentas de comercio electrónico — Braintree otorga acceso por cuenta de comercio electrónico, por lo que una cuenta sin actividad no contribuye.

Cree el usuario de la API y las claves#

1. Inicie sesión en el panel de control de Braintree como administrador y cree el rol anterior.
2. Cree un nuevo usuario y habilite Acceso a la API para ese usuario.
3. Asigne el rol de acceso limitado que ha creado.
4. Seleccione todas las cuentas de comerciante.
5. Cierre sesión y vuelva a iniciar sesión como ese nuevo usuario, luego genere y copie el Merchant ID, Clave Pública y Clave Privada.

Credenciales que Athia solicita#

Configurar la conexión.#

1. Crear el rol, asignarlo al usuario de la API y asignar ese usuario a cada cuenta de comerciante.
2. En Configuración → Conexiones, seleccionar + Agregar Conexión y elegir cerebro.
3. En Configurar Conector, introduzca un Nombre y seleccionar Programa.
4. En Introducir Credenciales, introducir Identificación del comerciante, Clave Pública y Clave Privada.
5. Seleccionar Verificar Conexión.

La conexión se mostrará entonces como ACTIVE y comenzará la primera sincronización. Verifique que las disputas y los clientes estén correctamente poblados; esta es la forma más rápida de confirmar que el rol es correcto.

Registrar el webhook de Athia en Braintree.#

Braintree envía actualizaciones de transacciones, suscripciones y disputas a Athia en tiempo real una vez que se ha registrado el destino.

1. En el asistente de conexión, copie la URL de destino del webhook de Athia.
2. Inicie sesión en el panel de control de Braintree como el usuario con acceso limitado y cree un webhook.
3. Pegue la URL de Athia en URL de destino.
4. En Notificaciones, habilite todas Opciones para eventos de notificación.
5. Prueba y guarda, luego habilita el webhook.

Cadencia de sincronización#

Seleccione un Programa que coincida con el nivel de seguimiento que utilices. Los registros de suscripción y de resolución de disputas avanzan según los propios ciclos de facturación y resolución de disputas de Braintree, independientemente de lo que elijas.

Límites y cosas que debes saber#

• La falta de permisos produce dominios vacíos, no errores. Sin permisos de lectura, las disputas y los clientes se sincronizan vacíos, aunque la verificación sigue teniendo éxito.
• La cobertura sigue la asignación de la cuenta del comerciante. Las cuentas a las que el usuario de la API no está asignado, están ausentes.
• La producción y el entorno de pruebas son conexiones separadas. Cada entorno emite su propio ID y par de claves de comerciante: crea una conexión por entorno y nunca mezcles las credenciales entre ellos.
• Los campos de liquidación y desembolso pueden retrasarse hasta dos días. con respecto a la transacción. Consulta los datos de liquidación en los días de vencimiento, no en el día actual.
• Los importes son decimales — nunca dividas entre 100.
• Los datos de la tarjeta se minimizan. El rol anterior otorga únicamente datos de pago enmascarados.

Resolución de problemas#

Relacionado#

Otros proveedores y rutas de ingestión se enumeran en Conectores de Athia. Para las transferencias de archivos y alternativas de almacén a almacén a un conector directo, consulta Integrando Athia.