Payment adapters

Mercado Pago

Guía paso a paso para dejar Mercado Pago funcionando en Lánzate.

1. Crear la app

1. Entra a Mercado Pago Developers.
2. Crea una aplicación nueva para tu SaaS.
3. Copia Access Token, Public Key y Webhook Secret.

Screenshot placeholder: Captura del panel de credenciales mostrando Access Token y Public Key.

2. Configurar env vars

MERCADOPAGO_ACCESS_TOKEN=""
MERCADOPAGO_PUBLIC_KEY=""
MERCADOPAGO_WEBHOOK_SECRET=""

3. Configurar provider

En src/config/app.ts:

payments: {
  provider: "mercadopago",
}

4. Webhook

URL:

https://tu-dominio.com/api/webhooks/payments

Screenshot placeholder: Formulario de webhook con la URL del proyecto.

5. Test mode y producción

• Prueba con credenciales de sandbox primero.
• Valida checkout, webhook y actualización de suscripción.
• Cambia a credenciales productivas cuando todo esté estable.

Stripe

1. Crear cuenta y API keys

1. Entra a Stripe Dashboard.
2. Copia Secret Key y Publishable Key.
3. Crea un webhook endpoint y copia el signing secret.

Screenshot placeholder: Pantalla de API keys en Stripe.

2. Variables de entorno

STRIPE_SECRET_KEY=""
STRIPE_PUBLISHABLE_KEY=""
STRIPE_WEBHOOK_SECRET=""

3. Provider

payments: {
  provider: "stripe",
}

4. Customer Portal

Si usarás billing self-service:

1. Activa Customer Portal.
2. Configura branding.
3. Prueba el retorno al dashboard.

5. Webhooks

Usa:

/api/webhooks/payments

Eventos mínimos:

• checkout.session.completed
• customer.subscription.updated
• customer.subscription.deleted
• invoice.payment_failed