---
title: "Habilitar compras con Flow Builder en el SDK de Android"
description: "Guía de inicio rápido para habilitar compras in-app con Adapty Flow Builder."
---
Para habilitar las compras in-app, necesitas entender tres conceptos clave:
- [**Productos**](product) – cualquier cosa que los usuarios pueden comprar (suscripciones, consumibles, acceso de por vida)
- [**Flows**](adapty-flow-builder) – secuencias de pantallas que presentan productos a los usuarios, creadas en el Flow Builder sin código. El SDK las recupera mediante `getFlow`. Si prefieres construir la UI en tu propio código, usa un paywall en su lugar — consulta [Implementar paywalls manualmente](android-quickstart-manual).
- [**Placements**](placements) – dónde y cuándo muestras los flows en tu app (como `main`, `onboarding`, `settings`). Asignas flows a placements en el dashboard y luego los solicitas por ID de placement en tu código. Esto facilita ejecutar pruebas A/B y mostrar flows distintos a diferentes usuarios.
Adapty te ofrece tres formas de habilitar las compras en tu app. Elige la que mejor se adapte a tus necesidades:
| Implementación | Complejidad | Cuándo usarlo |
|---|---|---|
| Adapty Flow Builder | ✅ Fácil | [Crea un flow completo y listo para compras en el builder sin código](quickstart-paywalls). Adapty lo renderiza automáticamente y gestiona todo el proceso de compra, validación de recibos y gestión de suscripciones entre bastidores. |
| Paywalls creados manualmente | 🟡 Media | Implementas la interfaz de tu paywall en el código de tu app, pero sigues obteniendo el objeto flow de Adapty para mantener flexibilidad en la oferta de productos. Consulta la [guía](android-quickstart-manual). |
| Modo Observer | 🔴 Difícil | Ya tienes tu propia infraestructura de gestión de compras y quieres seguir usándola. Ten en cuenta que el modo Observer tiene sus limitaciones en Adapty. Consulta el [artículo](observer-vs-full-mode). |
:::important
**Los pasos a continuación muestran cómo implementar un flow creado en el Adapty Flow Builder.**
Si prefieres construir la UI del paywall tú mismo, consulta [Implementar paywalls manualmente](android-quickstart-manual).
:::
Para mostrar un flow creado en el Adapty Flow Builder, en el código de tu app solo necesitas:
1. **Obtener el flow**: Obténlo desde Adapty.
2. **Mostrarlo y dejar que Adapty gestione las compras por ti**: Muestra la vista en tu app.
3. **Gestionar las acciones de los botones**: Asocia las interacciones del usuario con la respuesta de tu app a ellas. Por ejemplo, abrir enlaces o cerrar el flow cuando los usuarios pulsen botones.
## Antes de empezar \{#before-you-start\}
Antes de empezar, completa estos pasos:
1. [Conecta tu app a Google Play](initial-android) en el Adapty Dashboard.
2. [Crea tus productos](create-product) en Adapty.
3. [Crea un flow y añade productos](create-paywall).
4. [Crea un placement y añade tu flow](create-placement).
5. [Instala y activa el SDK](sdk-installation-android) en el código de tu app. Esta guía usa las APIs del SDK de Adapty para Android v4.
:::tip
La forma más rápida de completar estos pasos es seguir la [guía de inicio rápido](quickstart) o crear flows y placements usando el [CLI para desarrolladores](developer-cli-quickstart).
:::
## 1. Obtén el flow \{#1-get-the-flow\}
Tus flows están asociados a placements configurados en el dashboard. Los placements te permiten mostrar distintos flows a diferentes audiencias o ejecutar [pruebas A/B](ab-tests).
Para obtener un flow creado en el Adapty Flow Builder, necesitas:
1. Obtener el objeto `flow` mediante el ID del [placement](placements) usando el método `getFlow` y comprobar si tiene una configuración de vista.
2. Obtener la configuración de vista con el método `getFlowConfiguration`. La configuración de vista contiene los elementos de UI y el estilo necesarios para mostrar el flow.
:::important
Para obtener la configuración de la vista, debes activar el interruptor **Show on device** en el Flow Builder. De lo contrario, obtendrás una configuración de vista vacía y el flow no se mostrará.
:::
```kotlin showLineNumbers
Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
if (result is AdaptyResult.Success) {
val flow = result.value
if (!flow.hasViewConfiguration) {
return@getFlow
}
AdaptyUI.getFlowConfiguration(flow) { configResult ->
if (configResult is AdaptyResult.Success) {
val flowConfiguration = configResult.value
}
}
}
}
```
```java showLineNumbers
Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
if (result instanceof AdaptyResult.Success) {
AdaptyFlow flow = ((AdaptyResult.Success) result).getValue();
if (!flow.hasViewConfiguration()) {
return;
}
AdaptyUI.getFlowConfiguration(flow, configResult -> {
if (configResult instanceof AdaptyResult.Success) {
AdaptyUI.FlowConfiguration flowConfiguration =
((AdaptyResult.Success) configResult).getValue();
// use loaded configuration
}
});
}
});
```
## 2. Mostrar el flow \{#display-the-flow\}
Ahora que tienes la configuración del flow, basta con añadir unas pocas líneas para mostrar tu flow.
Para mostrar el flow visual en la pantalla del dispositivo, primero debes configurarlo. Para ello, llama al método `AdaptyUI.getFlowView()` o crea el `AdaptyFlowView` directamente:
```kotlin showLineNumbers
val flowView = AdaptyUI.getFlowView(
activity,
flowConfiguration,
null, // products = null means auto-fetch
eventListener,
)
```
```kotlin showLineNumbers
val flowView =
AdaptyFlowView(activity) // or retrieve it from xml
...
with(flowView) {
showFlow(
flowConfiguration,
null, // products = null means auto-fetch
eventListener,
)
}
```
```java showLineNumbers
AdaptyFlowView flowView = AdaptyUI.getFlowView(
activity,
flowConfiguration,
null, // products = null means auto-fetch
eventListener
);
```
```java showLineNumbers
AdaptyFlowView flowView =
new AdaptyFlowView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
flowView.showFlow(flowConfiguration, products, eventListener);
```
```xml showLineNumbers
```
Una vez que la vista se haya creado correctamente, puedes añadirla a la jerarquía de vistas y mostrarla en la pantalla del dispositivo.
:::tip
Para más detalles sobre cómo mostrar un flow, consulta nuestra [guía](android-present-paywalls).
:::
## 3. Gestionar las acciones de los botones \{#handle-button-actions\}
Cuando los usuarios hacen clic en los botones del flow, el SDK de Android gestiona automáticamente las compras, la restauración, el cierre del flow y la apertura de enlaces.
Sin embargo, otros botones tienen IDs personalizados o predefinidos y requieren gestionar las acciones en tu código. O puede que quieras sobreescribir su comportamiento predeterminado.
Por ejemplo, aquí se muestra el comportamiento predeterminado del botón de cierre. No necesitas añadirlo en el código, pero aquí puedes ver cómo se hace si fuera necesario.
:::tip
Lee nuestras guías sobre cómo gestionar [acciones](android-handle-paywall-actions) y [eventos](android-handling-events) de botones.
:::
```kotlin showLineNumbers title="Kotlin"
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
AdaptyUI.Action.Close -> (context as? Activity)?.onBackPressed() // default behavior
}
}
```
```java showLineNumbers
@Override
public void onActionPerformed(@NonNull AdaptyUI.Action action, @NonNull Context context) {
if (action instanceof AdaptyUI.Action.Close) {
if (context instanceof Activity) {
((Activity) context).onBackPressed();
}
}
}
```
## Próximos pasos \{#next-steps\}
:::tip
¿Tienes preguntas o estás teniendo algún problema? Consulta nuestro [foro de soporte](https://adapty.featurebase.app/) donde encontrarás respuestas a preguntas frecuentes o podrás plantear las tuyas. ¡Nuestro equipo y la comunidad están aquí para ayudarte!
:::
Tu paywall está listo para mostrarse en la app. [Prueba tus compras en Google Play Store](testing-on-android) para asegurarte de que puedes completar una compra de prueba desde el paywall.
A continuación, debes [comprobar el nivel de acceso de los usuarios](android-check-subscription-status) para asegurarte de que muestras un paywall o das acceso a las funciones de pago a los usuarios correctos.
## Ejemplo completo \{#full-example\}
Aquí tienes cómo integrar todos esos pasos en tu app.
```kotlin showLineNumbers title="Kotlin"
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
Adapty.getFlow("YOUR_PLACEMENT_ID") { flowResult ->
if (flowResult is AdaptyResult.Success) {
val flow = flowResult.value
if (!flow.hasViewConfiguration) {
// Use custom logic
return@getFlow
}
AdaptyUI.getFlowConfiguration(flow) { configResult ->
if (configResult is AdaptyResult.Success) {
val flowConfiguration = configResult.value
val flowView = AdaptyUI.getFlowView(
this,
flowConfiguration,
null, // products = null means auto-fetch
object : AdaptyFlowDefaultEventListener() {
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
is AdaptyUI.Action.Close -> {
(context as? Activity)?.onBackPressed()
}
}
}
}
)
setContentView(flowView)
}
}
}
}
}
}
```
```java showLineNumbers
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Adapty.getFlow("YOUR_PLACEMENT_ID", flowResult -> {
if (flowResult instanceof AdaptyResult.Success) {
AdaptyFlow flow = ((AdaptyResult.Success) flowResult).getValue();
if (!flow.hasViewConfiguration()) {
// Use custom logic
return;
}
AdaptyUI.getFlowConfiguration(flow, configResult -> {
if (configResult instanceof AdaptyResult.Success) {
AdaptyUI.FlowConfiguration flowConfiguration =
((AdaptyResult.Success) configResult).getValue();
AdaptyFlowView flowView = AdaptyUI.getFlowView(
this,
flowConfiguration,
null, // products = null means auto-fetch
new AdaptyFlowDefaultEventListener() {
@Override
public void onActionPerformed(@NonNull AdaptyUI.Action action, @NonNull Context context) {
if (action instanceof AdaptyUI.Action.Close) {
if (context instanceof Activity) {
((Activity) context).onBackPressed();
}
}
}
}
);
setContentView(flowView);
}
});
}
});
}
}
```