Pagos: Stripe, Mercado Pago, Pagar.me y Hotmart

Sin una pasarela conectada, la pantalla de checkout de la app existe pero la compra no se completa. El dinero va directo a tu cuenta en el proveedor: la plataforma no intermedia el pago ni cobra créditos de integración por él.

Antes de empezar

• Plan: Builder;
• Cuenta en el proveedor: Stripe, Mercado Pago o Pagar.me (crear la cuenta y usar el modo de prueba es gratis en los tres; las tarifas por venta son las de cada proveedor);
• Una pasarela por app. Stripe, Mercado Pago y Pagar.me comparten el mismo lugar: guardar una reemplaza a la otra. Hotmart es aparte y puede convivir con ellas;
• No sirve dentro de la app de las tiendas. En la app instalada desde la App Store o Google Play, quien cobra es la tienda. Ese es otro tema, en Vender suscripciones dentro de la app.

Todas están en la pestaña Integraciones, categoría Pagos.

Prueba antes de vender

Ninguna de las tres pasarelas tiene botón de entorno en la tarjeta: el entorno es el de la clave que pegas. Empieza siempre por las claves de prueba, haz una compra de prueba y solo entonces cámbialas por las de producción.

Al cambiarlas, escribe las claves de producción en sus campos. Un campo que queda en blanco conserva el valor guardado, así que una clave de prueba en un campo que no escribiste sigue valiendo.

Al cambiar de pasarela (por ejemplo, de Stripe a Mercado Pago), las claves de la anterior no pasan a la nueva: completa los campos de la tarjeta de la nueva pasarela.

Stripe

Campos de la tarjeta: Clave publicable (pk_), Clave secreta (sk_) y Secreto del webhook (whsec_).

1. en dashboard.stripe.com, activa el modo de prueba;
2. en Desarrolladores → Claves de API, copia la clave publicable (pk_test_…) y la secreta (sk_test_…);
3. en la tarjeta Stripe, pega las dos y deja el Secreto del webhook en blanco;
4. haz clic en Guardar y activar.

La plataforma prueba la clave secreta y crea el webhook sola en tu cuenta de Stripe. La tarjeta muestra el bloque URL del webhook con el sello Automático y la lista de eventos: no hay nada que hacer en el panel de Stripe.

Para producción, repite con el modo de prueba desactivado (pk_live_… y sk_live_…).

Mercado Pago

Campos de la tarjeta: Public Key, Access Token y Clave secreta del webhook.

Mercado Pago no permite crear el webhook por API, así que esta es la única de las tres con un paso manual.

1. en el panel de desarrolladores de Mercado Pago (mercadopago.com.br/developers/panel), crea una aplicación;
2. en Credenciales de prueba, copia la Public Key y el Access Token;
3. en la tarjeta Mercado Pago, pega los dos y haz clic en Guardar y activar;
4. la tarjeta pasa a mostrar el bloque URL del webhook con el sello Manual, la URL con el botón Copiar y los Eventos a habilitar;
5. en el panel de Mercado Pago, en Tus integraciones → Webhooks, pega la URL, marca los eventos listados y guarda;
6. copia la clave secreta que Mercado Pago generó para ese webhook;
7. vuelve a la tarjeta, completa la Clave secreta del webhook y haz clic otra vez en Guardar y activar. La Public Key y el Access Token pueden quedar en blanco: se conserva el valor guardado.

Sin la clave secreta del webhook, la plataforma no puede confirmar los avisos de pago, y la compra no libera nada en la app.

Pagar.me

Campos de la tarjeta: Clave de API (secret) y Clave pública (encryption).

1. en el panel de Pagar.me, ve a Configurações → Chaves de API y elige el entorno de prueba;
2. copia la clave secreta (sk_…) y la pública (pk_…);
3. en la tarjeta Pagar.me, pega las dos y haz clic en Guardar y activar;
4. la tarjeta muestra el bloque URL del webhook con el sello Manual. La URL ya incluye un usuario y una contraseña generados por la plataforma: trátala como secreta;
5. en el panel de Pagar.me, en Configurações → Webhooks, pega esa URL y marca los Eventos a habilitar que lista la tarjeta.

No existe un campo de secreto de webhook que completar en Pagar.me: la autenticación ya va dentro de la URL.

Hotmart

Hotmart no es una pasarela de la app. Vende desde su propio sitio, y la integración hace que la app reconozca a quien ya compró y libere el acceso sola.

Campos de la tarjeta: Client ID, Client Secret, Hottok (del Webhook), Código(s) del producto que libera la app y la opción Usar el entorno de pruebas (sandbox).

1. en Hotmart, en Herramientas > Credenciales Developers, crea la credencial y copia el Client ID y el Client Secret;
2. en Herramientas > Webhook, copia el hottok;
3. en la tarjeta Hotmart, completa los campos. En Código(s) del producto que libera la app, indica el código del producto (separa con comas si hay más de uno);
4. marca Usar el entorno de pruebas (sandbox) solo si las credenciales son de prueba;
5. haz clic en Guardar y activar. La plataforma le pregunta a Hotmart de quién es la cuenta y muestra "Conectado a Hotmart" con el nombre de la cuenta entre paréntesis, lo que confirma que conectaste la cuenta correcta;
6. copia la URL del webhook que muestra la tarjeta y pégala en el panel de Hotmart, en Herramientas > Webhook, eligiendo los eventos de compra y suscripción.

Dentro de la app publicada en las tiendas la venta no puede ocurrir: la app solo libera lo que se compró en el sitio.

Cómo hacer el primer pago de prueba

1. conecta la pasarela con las claves de prueba;
2. si la app todavía no tiene pantalla de compra, pídela en el chat (por ejemplo: "crea la página de planes con botón de suscribirse"). Esta parte gasta créditos de IA, como cualquier construcción;
3. abre la app y haz una compra. En Stripe, la tarjeta de prueba es 4242 4242 4242 4242, con cualquier fecha futura y cualquier código de seguridad. En Mercado Pago y Pagar.me, usa las tarjetas de prueba de la documentación de cada uno;
4. revisa la compra en el panel del proveedor, en modo de prueba, y comprueba si la app liberó lo que se compró.

Cambia a las claves de producción solo después de que todo ese ciclo funcione.

Cómo saber que funcionó

• la tarjeta muestra Conectada. En las tres pasarelas y en Hotmart ese sello viene de una prueba real con el proveedor, no solo del formulario guardado;
• en Stripe, el bloque del webhook tiene el sello Automático;
• en Mercado Pago, la clave secreta del webhook se guardó después de crear el webhook en el panel;
• la compra de prueba aparece en el panel del proveedor y la app libera el acceso.

Problemas comunes

• Error de configuración nada más guardar. La clave secreta fue rechazada: comprueba que copiaste la secreta (y no la publicable) y que no quedó un espacio al principio o al final;
• El pago se aprueba en el proveedor y la app no libera nada. Es el webhook. En Mercado Pago, falta la clave secreta o algún evento. En Pagar.me, la URL pegada no es la que muestra la tarjeta o falta un evento;
• Cambié de pasarela y la anterior dejó de funcionar. Es lo esperado: solo una queda activa por app;
• El botón de suscribirse no aparece en la app instalada desde la tienda. Dentro de la app de las tiendas la pasarela nunca se usa. Consulta Vender suscripciones dentro de la app.