Guía de integración con Braintree y PayPal: conecta FlyCode
Conecta FlyCode a Braintree o PayPal para recuperar pagos fallidos de suscripciones: rol restringido, usuario de API, cuenta de comerciante, lista de verificación para salir en producción y solución de problemas.
Para quién es esto
Empresas SaaS y de suscripciones B2C y B2B que procesan pagos recurrentes a través de Braintree (incluido PayPal vía Braintree) y que quieren recuperar más pagos fallidos y reducir la cancelación involuntaria sin cambiar su integración de facturación.
Requisitos previos
Acceso al Panel de control de Braintree con permiso para gestionar roles y usuarios (Administrador de la cuenta).
Los ID(s) de cuenta de comerciante que quieres que FlyCode cubra.
Una cuenta de FlyCode. Comenzar si no tienes una; recibirás la dirección de correo de FlyCode para usarla con el usuario de la API.
Configuración
Crear un rol de FlyCode
En el Panel de control de Braintree, ve a Configuración, Equipo, Roles, y crea un nuevo rol llamado FlyCode. Concede solo los permisos que se muestran abajo (acceso de lectura a clientes, métodos de pago, suscripciones y transacciones, y la capacidad de crear transacciones y actualizar suscripciones). No concedas permisos de liquidación, reembolso ni configuración de la cuenta.
Añadir un usuario de API de FlyCode
Ve a Configuración, Equipo, Usuarios, Añadir nuevo usuario. Introduce la dirección de correo de FlyCode que recibiste durante el registro y luego:
Activar Acceso a la API.
En Roles, selecciona el rol de FlyCode que creaste en el Paso 1.
En Cuenta de comerciante, selecciona la(s) cuenta(s) que FlyCode debe cubrir.
Haz clic en Crear usuario. Braintree genera las credenciales de API para el usuario.
Compartir credenciales y establecer una fecha de lanzamiento
Comparte las credenciales de la API con FlyCode a través del canal seguro proporcionado durante la incorporación (nunca por correo electrónico sin cifrar). FlyCode se conecta, carga las transacciones fallidas existentes y las suscripciones en estado de vencidas, y acuerda una fecha de lanzamiento contigo. Si Braintree o tu sistema de facturación envían correos electrónicos por pagos fallidos, decide si FlyCode o tu sistema es el responsable de la mensajería.
Cómo se comporta FlyCode en Braintree y PayPal
Reintenta las transacciones fallidas de suscripción con una temporización guiada por el modelo dentro de los límites de la red de tarjetas.
No reintenta rechazos definitivos; recurre a otro método de pago guardado cuando está disponible; de lo contrario, activa el contacto.
Registra cada reintento como una transacción de Braintree visible en el Panel de control y reflejada en tus informes existentes.
Puede configurarse para cuentas de comerciante específicas.
Lista de verificación para la puesta en marcha
Solución de problemas
FlyCode informa que no puede leer suscripciones ni transacciones. Falta un permiso de lectura en el rol, o el usuario no está asignado a la cuenta de comerciante correcta. Comprueba la captura de pantalla del Paso 1.
Los reintentos no aparecen. El acceso a la API no está habilitado en el usuario, o aún no se ha alcanzado la fecha de lanzamiento.
Correos electrónicos duplicados de clientes. Tanto tu sistema de facturación como FlyCode están enviando mensajes sobre pagos fallidos. Elige un único responsable.
Preguntas frecuentes
¿FlyCode necesita acceso completo de administrador? No. El rol restringido limita a FlyCode a leer objetos de facturación y crear transacciones de reintento.
¿Esto cubre los pagos con monedero de PayPal? Sí, para los métodos de pago de PayPal almacenados en Braintree. El comportamiento de reintento sigue las reglas de PayPal para transacciones de referencia.
¿Puedo revocar el acceso? Sí, en cualquier momento eliminando o desactivando el usuario de FlyCode en Braintree.
Relacionado
Consideraciones de integración en el Centro de ayuda
Última actualización
¿Te fue útil?