Saltar al contenido principal
En esta página

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. Antes de comenzar

Antes de empezar#

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#

campoRequeridoQué es / dónde encontrarlo
NombreSíPrograma
ProgramaciónNoCon qué frecuencia Athia consulta a Braintree
Identificación del comercianteSíEl ID de comerciante de Braintree que cubre esta conexión
Clave PúblicaSíSe emite con el usuario de la API: consulte la documentación de Braintree para saber dónde se encuentra.
Clave PrivadaSíConfigurar la conexión.

Configuración de la conexión#

  1. Crear el rol, asignarlo al usuario de la API y asignar ese usuario a cada cuenta de comerciante.
  2. En , seleccionar, seleccione y elegir y seleccione cerebro.
  3. En , introduzca un, introduzca y seleccionar Programa Programación.
  4. Introducir Credenciales Ingrese Credenciales, introducir Identificación del comerciante, Clave Pública y Seleccionar.
  5. Verificar Conexión La conexión se mostrará entonces como.

La conexión ahora muestra 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. URL de destino del webhook de Athia 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 En.
  4. bajo Notificaciones, habilite todas Opciones para eventos de notificación.
  5. Prueba y guarda, luego habilita el webhook.

Cadencia de sincronización#

Programa Programación Límites y cosas que debes saber

Límites y cosas que 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. Los importes son decimales
  • Los montos son decimales Los datos de la tarjeta se minimizan.
  • Los datos de la tarjeta están minimizados. El rol anterior otorga únicamente datos de pago enmascarados.

Lo que ves#

Lo que veCausa probableQué hacer
Disputas o clientes que quedan vacíos después de una sincronizaciónRol sin gestión de disputas o permisos de solo lecturaAñade los permisos y vuelve a conectar

Otros proveedores y rutas de ingestión se enumeran en Conectores de AthiaIntegrando Athia Integración de Athia.