> For the complete documentation index, see [llms.txt](https://docs.flycode.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flycode.com/docs/es/integrations/how-to-connect-flycode-to-your-braintree-paypal-account.md).

# Guía de integración de Braintree y PayPal: conecta FlyCode

{% hint style="info" %}
**Resumen:** En el Panel de control de Braintree, crea un rol de FlyCode con solo los permisos que FlyCode necesita, añade un usuario con acceso a la API asignado a ese rol para la cuenta de comerciante que quieras cubrir y comparte las credenciales de forma segura con FlyCode. FlyCode entonces recupera los pagos fallidos de suscripciones en Braintree y PayPal con temporización de reintentos basada en aprendizaje automático y mensajería coordinada. Sin cambios de código.
{% endhint %}

## 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](https://www.flycode.com/get-started) si no tienes una; recibirás la dirección de correo de FlyCode para usarla con el usuario de la API.

## Configuración

{% stepper %}
{% step %}

### 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.

<figure><img src="https://857825088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FedoXR9BFShbgporwvi7n%2Fuploads%2FYvPU28U7LeelMbRY0IPk%2FScreenshot%202024-06-18%20at%2012.46.49%20(1).png?alt=media&#x26;token=74d431a2-7269-4ff0-adac-442c1385a615" alt=""><figcaption><p>Permisos para el rol de FlyCode</p></figcaption></figure>
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
{% endstep %}
{% endstepper %}

## 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

* [ ] Rol de FlyCode creado con permisos restringidos
* [ ] Usuario de API de FlyCode creado con acceso a la API, rol de FlyCode y cuenta de comerciante correcta
* [ ] Credenciales compartidas de forma segura
* [ ] Responsable de la mensajería decidido
* [ ] Fecha de lanzamiento acordada

## 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

* [Plataformas de pago y suscripción compatibles](https://docs.flycode.com/docs/integrations/supported-payment-and-subscription-platforms)
* [¿Qué es FlyCode?](https://docs.flycode.com/docs/introduction/what-is-flycode)
* [Consideraciones de integración](https://help.flycode.com/understanding-involuntary-churn/integration-considerations) en el Centro de ayuda


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flycode.com/docs/es/integrations/how-to-connect-flycode-to-your-braintree-paypal-account.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
